registry search

Search the 1MCP registry for MCP servers using various filters and criteria. Find servers by name, category, tags, or functionality with advanced filtering options.

Synopsis

Search for servers by name or keyword:

npx -y @1mcp/agent registry search <query>

Browse all available servers:

npx -y @1mcp/agent registry search

Filter by transport type:

npx -y @1mcp/agent registry search --transport=stdio

Advanced filtering with multiple criteria:

npx -y @1mcp/agent registry search database --type=npm --format=json

Arguments

<query> (optional) : Search query string to match against server names, descriptions, and tags. Supports partial matching and fuzzy search.

Global Options

• --config, -c <path> - Specify configuration file path
• --config-dir, -d <path> - Path to the config directory

Command-Specific Options

• --status <status>

  • Filter by server status
  • Choices: active, archived, deprecated, all
  • Default: active

• --type <type>

  • Filter by package registry type
  • Choices: npm, pypi, docker

• --transport <transport>

  • Filter by transport method
  • Choices: stdio, sse, http

• --limit <number>

  • Maximum number of results to return
  • Default: 20
  • Maximum: 100

• --cursor <string>

  • Pagination cursor for retrieving next page of results

• --format <format>

  • Output format for search results
  • Choices: table, list, json
  • Default: table

Examples

Basic Search

Search for filesystem-related servers:

npx -y @1mcp/agent registry search filesystem

Filter by Transport

Find servers that use stdio transport:

npx -y @1mcp/agent registry search --transport=stdio

Filter by Package Type

Search for npm packages only:

npx -y @1mcp/agent registry search --type=npm database

Limit Results

Get only the first 5 results:

npx -y @1mcp/agent registry search database --limit=5

JSON Output

Get machine-readable results:

npx -y @1mcp/agent registry search database --format=json

List All Active Servers

Browse all available servers:

npx -y @1mcp/agent registry search --status=active

Search Syntax

Query Format

Search queries support flexible matching:

# Exact name match
registry search filesystem

# Partial name match
registry search file

# Description match
registry search "file system"

# Tag match
registry search storage

# Fuzzy matching
registry search flsystm  # Matches "filesystem"

Special Operators

Use special operators for advanced searches:

# Exact phrase match
registry search "file system access"

# Exclude terms
registry search database --not=mysql

# Wildcard matching
registry search py*  # Matches python, pytorch, etc.

# Regular expressions
registry search --regex="^(git|svn|hg)$"

Categories and Tags

Available Categories

• System - File system, backup, utilities
• Database - Database servers and clients
• Development - Build tools, version control
• Web - HTTP clients, web scraping
• Network - Network protocols, APIs
• Storage - Cloud storage, object storage
• Communication - Email, chat, notifications
• Data Processing - Analytics, ML, ETL
• Security - Authentication, encryption
• Monitoring - Logging, metrics, alerts

Common Tags

• Transport: stdio, http, sse
• Platform: linux, darwin, win32, web
• Functionality: api, cli, gui, batch
• Language: python, javascript, go, rust
• Environment: development, production, testing
• Security: trusted, verified, sandboxed

Sorting and Pagination

Sort Options

# Sort by popularity (most downloaded)
registry search --sort=popularity

# Sort by recently updated
registry search --sort=updated

# Sort by name (alphabetical)
registry search --sort=name

# Sort by creation date
registry search --sort=created

# Sort by download count
registry search --sort=downloads

Pagination

Control result display:

# Limit results
registry search --limit=10

# Skip first N results
registry search --offset=20

# Show all results (up to max 100)
registry search --limit=100

Registry Caching

Search results are cached for performance:

# Force refresh cache
registry search --refresh

# Check cache status
registry status --cache

# Clear cache
registry cache --clear

Integration Examples

Pipeline to Install

Search and install servers:

# Search and install top result
registry search database --limit=1 --output=json | \
  jq -r '.results[0].name' | \
  xargs npx -y @1mcp/agent mcp install

# Install all database servers
registry search --category=database --output=list | \
  xargs -n1 npx -y @1mcp/agent mcp install

Update Check Automation

Check for updates in scripts:

#!/bin/bash
# Check for servers with updates
updates=$(registry search --updates --output=json)
count=$(echo "$updates" | jq '.total')

if [ "$count" -gt 0 ]; then
  echo "Found $count available updates:"
  echo "$updates" | jq -r '.results[] | "  • \(.name): \(.current) → \(.latest)"'

  # Ask user if they want to update
  read -p "Update all servers? (y/N): " -n 1 -r
  echo
  if [[ $REPLY =~ ^[Yy]$ ]]; then
    registry search --updates --output=list | \
      xargs -n1 npx -y @1mcp/agent mcp update
  fi
fi

See Also

• mcp install - Install servers from search results
• Server Management Guide - Server management overview