# Smithery MCP Registry Scraper (`jungle_synthesizer/smithery-mcp-registry-scraper`) Actor Scrape the Smithery MCP registry for the full catalog of Model Context Protocol (MCP) servers. Pulls server metadata, tools, resources, prompts, use counts, verification status, and deployment info. Filter by search query or fetch details on a single server by qualified name. - **URL**: https://apify.com/jungle\_synthesizer/smithery-mcp-registry-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** AI, Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Smithery MCP Registry Scraper Scrape the [Smithery](https://smithery.ai) Model Context Protocol (MCP) server registry. Returns server metadata, use counts, verification status, deployment info, and optionally the full tool/resource/prompt schemas for each server — covering 5,000+ entries and growing weekly. --- ### Smithery MCP Registry Scraper Features - Extracts the full Smithery catalog: 5,000+ MCP servers with name, description, use count, verification badge, and deployment URL - Supports three modes: full catalog sweep, keyword search, or single-server detail lookup - Retrieves per-server tool schemas, resource definitions, and prompt specs when `includeTools` is enabled - Returns the connection type (HTTP, stdio) and config schema for each server - No proxy required. Smithery's public API returns clean JSON without auth or browser rendering - Handles page-based pagination automatically — point it at the catalog and walk away --- ### What Can You Do With Smithery MCP Data? - **AI agent builders** — Discover and index MCP servers that match your agent's domain, then wire in the right tools without manually browsing the directory - **IDE / editor integrations** — Pull the full catalog to populate server-picker UIs in Cursor, Windsurf, Zed, or any MCP-capable client - **Competitive intelligence** — Track which MCP servers are gaining use counts fastest, who's verified, and what tool schemas they expose - **Developer relations teams** — Export the registry to find servers in your product category and reach out to their owners - **Security and compliance** — Audit the full catalog for config schemas that accept sensitive parameters before onboarding servers to your platform --- ### How Smithery MCP Registry Scraper Works 1. Choose a mode: full catalog, keyword search, or single-server detail 2. The scraper calls Smithery's public JSON API at `registry.smithery.ai/servers` with page-based pagination 3. For each server listing, it records the metadata from the catalog endpoint — name, use count, verified status, and deployment info 4. If `includeTools` is enabled, it fetches each server's detail endpoint separately to get tool schemas, resource definitions, and prompt specs --- ### Input ```json { "mode": "catalog", "maxItems": 100, "includeTools": false, "verifiedOnly": false } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `mode` | string | `catalog` | `catalog` (full sweep), `search` (keyword query), or `server_detail` (single server by qualified name) | | `query` | string | `""` | Keyword to search — used in `search` mode | | `qualifiedName` | string | `""` | Exact server identifier, e.g. `exa` or `upstash/context7-mcp` — used in `server_detail` mode | | `verifiedOnly` | boolean | `false` | If true, limits results to Smithery-verified servers | | `includeTools` | boolean | `false` | Fetch per-server detail (tools, resources, prompts) — adds one HTTP call per server | | `maxItems` | integer | `10` | Max servers to return; `0` means no limit | **Search mode example:** ```json { "mode": "search", "query": "github", "maxItems": 50 } ``` **Single-server detail example:** ```json { "mode": "server_detail", "qualifiedName": "upstash/context7-mcp" } ``` *** ### Smithery MCP Registry Scraper Output Fields **Catalog / search mode output:** ```json { "qualified_name": "upstash/context7-mcp", "display_name": "Context7", "description": "Fetch up-to-date documentation and code examples directly into your prompts.", "icon_url": "https://api.smithery.ai/servers/upstash/context7-mcp/icon", "homepage_url": "https://github.com/upstash/context7", "verified": true, "use_count": 11216, "is_deployed": true, "by_smithery": false, "remote": true, "deployment_url": null, "tools_count": null, "tools": null, "connection_type": null, "server_url": "https://smithery.ai/server/upstash/context7-mcp", "created_at": "2025-04-12T07:00:21.424Z" } ``` | Field | Type | Description | |-------|------|-------------| | `qualified_name` | string | Unique `namespace/slug` identifier on Smithery | | `display_name` | string | Human-readable server name | | `description` | string | Server description from the registry | | `icon_url` | string | URL to the server's icon image | | `homepage_url` | string | Server homepage or documentation URL | | `verified` | boolean | Whether Smithery has verified this server | | `use_count` | number | Cumulative installs reported by Smithery | | `is_deployed` | boolean | Whether the server has a hosted remote deployment | | `by_smithery` | boolean | Whether the server is published by Smithery itself | | `remote` | boolean | Whether the server supports remote connections | | `deployment_url` | string | Remote deployment URL when `is_deployed` is true | | `server_url` | string | Direct URL to the Smithery server page | | `created_at` | string | Creation timestamp (ISO 8601) | **With `includeTools: true`, these fields are also populated:** | Field | Type | Description | |-------|------|-------------| | `tools_count` | number | Number of tools the server exposes | | `resources_count` | number | Number of resources the server exposes | | `prompts_count` | number | Number of prompts the server exposes | | `tools` | array | Tool names and descriptions as `"name\|description"` strings | | `resources` | array | Resource names and URIs as `"name\|uri"` strings | | `prompts` | array | Prompt names and descriptions as `"name\|description"` strings | | `connection_type` | string | Primary connection type (`http`, `stdio`) | | `config_schema_json` | string | JSON-encoded config schema for the connection | *** ### 🔍 FAQ #### How do I scrape the full Smithery MCP catalog? Set `mode` to `catalog` and `maxItems` to `0`. The scraper pages through the entire registry at `pageSize=100` and collects every server. There are currently 5,000+ servers, which takes a few minutes at the default 200ms politeness delay. #### How much does Smithery MCP Registry Scraper cost to run? Smithery MCP Registry Scraper charges $0.10 to start plus $0.001 per record. Scraping 5,000 servers costs roughly $5.10. With `includeTools: true`, run time increases but the per-record charge stays the same. #### What's the difference between catalog mode and server\_detail mode? Catalog mode pages through listing data — fast, good for bulk exports. The listing endpoint doesn't return tool or resource schemas. Use `server_detail` when you need a single server's full schema, or set `includeTools: true` in catalog or search mode to enrich every record with detail data. #### Does Smithery MCP Registry Scraper need proxies? No. Smithery's public registry API is open — no auth, no geo-restriction, and no bot detection beyond Cloudflare's CDN layer, which passes through without challenge on standard HTTP requests. #### Can I filter to verified servers only? Yes. Set `verifiedOnly: true` in any mode. Verified servers are a subset of the catalog that Smithery has reviewed and badged. *** ### Need More Features? Need additional fields, custom filters, or cross-registry comparison with Glama? [File an issue](https://console.apify.com/actors/issues) or get in touch. ### Why Use Smithery MCP Registry Scraper? - **First mover** — The only Apify actor targeting the Smithery registry, which is the dominant MCP directory referenced directly in Anthropic, Cursor, and Windsurf documentation - **Clean output** — Returns structured JSON with consistent field names, including optional per-server tool and resource schemas not available from any other programmatic source - **No overhead** — Pure JSON API scraping, no browser required, no proxies needed, runs in 256MB memory # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `mode` (type: `string`): Catalog listing, single-server detail, or search query. ## `query` (type: `string`): Search server name, description, or tags. Used in 'search' mode. ## `qualifiedName` (type: `string`): namespace/slug identifier of a single server (e.g. 'exa' or 'upstash/context7-mcp'). Used in 'server\_detail' mode. ## `verifiedOnly` (type: `boolean`): Only return servers marked as Verified by Smithery. ## `includeTools` (type: `boolean`): Fetch per-server detail (tools, resources, prompts, connections schema) for each server. Increases run time significantly for large catalogs. ## `maxItems` (type: `integer`): Maximum servers to return. 0 = unlimited (full catalog). ## `proxyConfiguration` (type: `object`): No description ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "catalog", "query": "", "qualifiedName": "", "verifiedOnly": false, "includeTools": false, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "catalog", "query": "", "qualifiedName": "", "verifiedOnly": false, "includeTools": false, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/smithery-mcp-registry-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "catalog", "query": "", "qualifiedName": "", "verifiedOnly": False, "includeTools": False, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/smithery-mcp-registry-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "catalog", "query": "", "qualifiedName": "", "verifiedOnly": false, "includeTools": false, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": false } }' | apify call jungle_synthesizer/smithery-mcp-registry-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/smithery-mcp-registry-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Smithery MCP Registry Scraper", "description": "Scrape the Smithery MCP registry for the full catalog of Model Context Protocol (MCP) servers. Pulls server metadata, tools, resources, prompts, use counts, verification status, and deployment info. Filter by search query or fetch details on a single server by qualified name.", "version": "0.1", "x-build-id": "Qt9u5OCV8lRdacFLh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~smithery-mcp-registry-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-smithery-mcp-registry-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jungle_synthesizer~smithery-mcp-registry-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-smithery-mcp-registry-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jungle_synthesizer~smithery-mcp-registry-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-smithery-mcp-registry-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "sp_intended_usage", "sp_improvement_suggestions" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "mode": { "title": "Mode", "enum": [ "catalog", "server_detail", "search" ], "type": "string", "description": "Catalog listing, single-server detail, or search query.", "default": "catalog" }, "query": { "title": "Search Query", "type": "string", "description": "Search server name, description, or tags. Used in 'search' mode.", "default": "" }, "qualifiedName": { "title": "Qualified Server Name", "type": "string", "description": "namespace/slug identifier of a single server (e.g. 'exa' or 'upstash/context7-mcp'). Used in 'server_detail' mode.", "default": "" }, "verifiedOnly": { "title": "Verified Servers Only", "type": "boolean", "description": "Only return servers marked as Verified by Smithery.", "default": false }, "includeTools": { "title": "Include Tools / Resources / Prompts", "type": "boolean", "description": "Fetch per-server detail (tools, resources, prompts, connections schema) for each server. Increases run time significantly for large catalogs.", "default": false }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum servers to return. 0 = unlimited (full catalog).", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```