---

name: find-mcp description: Search and discover MCP servers from the official Model Context Protocol registry. Use this skill when users want to find MCP servers, explore available integrations, or discover new capabilities. license: MIT

Find MCP Servers

This skill helps you search and discover MCP (Model Context Protocol) servers from the official registry at https://registry.modelcontextprotocol.io.

MCP Registry API

Base URL: https://registry.modelcontextprotocol.io

Search Servers

GET /v0.1/servers

Query Parameters:

• search - Search by server name (substring match)
• limit - Number of results per page (1-100, default: 30)
• cursor - Pagination cursor for next page
• version - Filter by version (use "latest" for latest version)
• updated_since - Filter servers updated since RFC3339 timestamp

Example Requests:

# Search for filesystem-related servers
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=filesystem"

# Get latest 50 servers
curl "https://registry.modelcontextprotocol.io/v0.1/servers?limit=50&version=latest"

# Search for brave search
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=brave"

Response Structure:

{
  "servers": [
    {
      "_meta": {
        "io.modelcontextprotocol.registry/official": {
          "status": "active",
          "publishedAt": "2025-01-15T10:00:00Z",
          "isLatest": true,
          "updatedAt": "2025-01-20T15:30:00Z"
        }
      },
      "server": {
        "name": "io.github.example/filesystem",
        "title": "Filesystem Access",
        "description": "MCP server for filesystem operations",
        "version": "1.0.2",
        "repository": {
          "url": "https://github.com/example/mcp-filesystem",
          "source": "github"
        },
        "packages": [...]
      }
    }
  ],
  "metadata": {
    "count": 1,
    "nextCursor": "cursor123"
  }
}

Get Specific Server

GET /v0.1/servers/{serverName}/versions/{version}

Parameters:

• serverName - URL-encoded server name (e.g., com.example%2Fmy-server)
• version - Version number or "latest"

Example:

# Get latest version of brave search server
curl "https://registry.modelcontextprotocol.io/v0.1/servers/io.modelcontextprotocol.servers%2Fbrave-search/versions/latest"

Get All Versions of a Server

GET /v0.1/servers/{serverName}/versions

Common Search Patterns

By Category/Functionality

• File operations: search=filesystem
• Search tools: search=brave, search=google
• Development: search=github, search=git
• Data processing: search=csv, search=json
• Web scraping: search=fetch, search=web
• Database: search=postgres, search=sqlite, search=database

By Transport Type

Servers support different transport types:

• stdio - Standard input/output (most common for npm packages)
• sse - Server-Sent Events
• streamable-http - Streaming HTTP

Filter by Registry Type

• npm - Node.js packages (@modelcontextprotocol/server-*)
• pypi - Python packages
• oci - OCI containers
• mcpb - MCP binary format

Installation Instructions

When presenting MCP servers to users, include installation instructions based on package type:

NPM Packages

npx @modelcontextprotocol/server-<name>

With Configuration

Many servers require configuration (API keys, etc.). Show the packageArguments from the registry response:

{
  "packageArguments": [
    {
      "name": "--api-key",
      "description": "API key for service",
      "isRequired": true,
      "isSecret": true
    }
  ]
}

Search Strategy

1. Start with broad search terms - Use single keywords first
2. Use substring matching - The API searches within server names and descriptions
3. Check multiple pages - Use nextCursor from metadata for pagination
4. Filter for latest - Always use version=latest for production use
5. Verify status - Check _meta.io.modelcontextprotocol.registry/official.status is "active"

Server Information to Present

When displaying results to users, show:

• Title/Name - Human-readable name and reverse-DNS identifier
• Description - What the server does
• Repository - Source code location
• Version - Latest version number
• Transport - How it connects (stdio/sse/http)
• Package Type - npm, pypi, etc.
• Installation Command - How to install
• Configuration - Required arguments/inputs

Error Handling

API returns errors in RFC 7807 format (application/problem+json):

{
  "type": "https://example.com/errors/example",
  "title": "Bad Request",
  "status": 400,
  "detail": "Property foo is required but is missing."
}

Common errors:

• 400 - Invalid query parameters
• 404 - Server not found
• 422 - Validation error

Examples

Find All Official MCP Servers

curl "https://registry.modelcontextprotocol.io/v0.1/servers?limit=100&version=latest"

Find GitHub Integration

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=github&version=latest"

Get Brave Search Details

curl "https://registry.modelcontextprotocol.io/v0.1/servers/io.modelcontextprotocol.servers%2Fbrave-search/versions/latest"

Related Resources

• MCP Registry: https://registry.modelcontextprotocol.io
• MCP Documentation: https://modelcontextprotocol.io
• MCP Servers Repository: https://github.com/modelcontextprotocol/servers