toolsdk-ai/toolsdk-mcp-registry

Start Here

• 🔍 I want to find an MCP Server → Browse Directory
• 🔌 I want to integrate MCP tools into my AI app → Integration Guide
• 🚀 I want to deploy an MCP Gateway → Deployment Guide
• ➕ I want to submit my MCP Server → Contribution Guide

[!IMPORTANT] Pro Tip: If a server is marked as validated: true, you can use it instantly with Vercel AI SDK:

const tool = await toolSDK.package('', { ...env }).getAISDKTool('');

Want validation? Ask AI: “Analyze the make build target in the Makefile and the scripts it invokes, and determine how an MCP server gets marked as validated: true.”

Getting Started

Deploy Enterprise Gateway (Recommended)

Deploy your own private MCP Gateway & Registry in minutes. This provides the full feature set: Federated Search, Remote Execution, Sandbox, and OAuth.

⚡ Quick Deploy (One-Liner)

Start the registry immediately with default settings:

docker compose up -d

Did this save you time? Give us a Star on GitHub — it helps others discover this registry!

Configuration:

• Set MCP_SANDBOX_PROVIDER=LOCAL in .env file if you want to disable the sandbox (not recommended for production).
• See Configuration Guide for full details.

[!TIP] Tip for Private Deployment: This registry contains 4547+ public MCP servers. If you only need a specific subset for your private environment, you can prune the packages/ directory. 📖 See Package Management Guide for details.

That’s it! Your self-hosted MCP registry is now running with:

• 🌐 HTTP API with OpenAPI documentation
• 🛡️ Secure Sandbox execution for AI agent tools
• 🔍 Full-text search (Meilisearch)

🎉 Access Your Private MCP Registry

• 🌐 Local Web Interface: http://localhost:3003
• 📚 Swagger API Docs: http://localhost:3003/swagger
• 🔍 Search & Execute 4547+ MCP Servers remotely
• 🤖 Integrate with your AI agents, chatbots, and LLM applications

🌐 Remote Tool Execution Example

Execute any MCP tool via HTTP API - perfect for AI automation, chatbot integrations, and serverless deployments:

curl -X POST http://localhost:3003/api/v1/packages/run \
  -H "Content-Type: application/json" \
  -d '{
    "packageName": "@modelcontextprotocol/server-everything",
    "toolKey": "echo",
    "inputData": {
      "message": "Hello from ToolSDK MCP Registry!"
    },
    "envs": {}
  }'

🔌 MCP Gateway (Streamable HTTP Proxy)

The registry also acts as an MCP Gateway — any registered package can be accessed as a standard Streamable HTTP endpoint, even if the original server is STDIO-only.

Endpoint: POST /mcp/

Pass environment variables via x-mcp-env-* headers:

curl -X POST http://localhost:3003/mcp/@modelcontextprotocol/server-github \
  -H "Content-Type: application/json" \
  -H "x-mcp-env-GITHUB_PERSONAL_ACCESS_TOKEN: ghp_your_token" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

The server returns a mcp-session-id header — include it in subsequent requests to reuse the session (sessions expire after 30 min).

This is useful for:

• Protocol Bridging — Expose local STDIO servers as remote HTTP endpoints
• Centralized Access — Give AI agents a single HTTP gateway to all MCP tools
• Client Compatibility — Connect from any MCP client that supports Streamable HTTP

Why ToolSDK MCP Registry?

ToolSDK MCP Registry is an enterprise-grade gateway for Model Context Protocol (MCP) servers. It solves the challenge of securely discovering and executing AI tools in production environments.

Key Features

• Federated Registry - Unified search across local private servers and the official @modelcontextprotocol/registry.
• Unified Interface - Access local STDIO tools and remote StreamableHTTP servers via a single, standardized HTTP API.
• Secure Sandbox - Execute untrusted tools in isolated environments (supports E2B, Daytona, Sandock).
• OAuth 2.1 Proxy - Built-in OAuth 2.1 implementation to handle complex authentication flows for your agents. Integration Guide
• Private & Self-Hosted - Full control over your data and infrastructure with Docker deployment.
• Developer-Friendly - OpenAPI/Swagger documentation and structured JSON configs.

Use Cases

• Enterprise AI Gateway - Centralize tool access for all your internal LLM applications.
• Secure Tool Execution - Run community MCP servers without risking your local environment.
• Protocol Adaptation - Connect remote agents (via HTTP API) to local CLI tools (via STDIO).
• Unified Discovery - One API to search and manage thousands of tools.

Architecture

graph TD
    subgraph ClientSide ["Client Side"]
        LLM["🤖 AI Agent / LLM"]
        User["👤 User / Developer"]
    end

    subgraph DockerEnv ["🐳 Self-Hosted Infrastructure"]
        
        subgraph RegistryCore ["Registry Core"]
            API["🌐 Registry API"]
            Search["🔍 Meilisearch"]
            DB["📚 Registry Data"]
            OAuth["🔐 OAuth Proxy"]
        end

        subgraph RuntimeEnv ["Runtime Environment"]
            Local["💻 Local Exec"]
            Sandbox["🛡️ Secure Sandbox"]
            MCPServer["⚙️ MCP Server"]
        end
    end

    User -->|Search Tools| API
    LLM -->|Execute Tool| API
    LLM -->|Auth Flow| OAuth
    API |Query Index| Search
    API -->|Read Metadata| DB
    API -->|Run Tool| Local
    API -->|Run Tool| Sandbox
    Local -->|Execute| MCPServer
    Sandbox -->|Execute| MCPServer

---

What You Get

This open-source project provides:

• Structured Registry - 4547+ MCP servers with metadata
• Unified Gateway - HTTP API to query and execute tools remotely
• Auto-Generated Docs - Always up-to-date README and API documentation

✅ Validated Packages = One-Line Integration (ToolSDK)

Some packages in this registry are marked as validated: true.

[!NOTE] What does validated: true mean for you?

• You can load the MCP package directly via our ToolSDK NPM client and get ready-to-use tool adapters (e.g. Vercel AI SDK tools) without writing your own tool schema mapping.
• The registry index includes the discovered tools metadata for validated packages, so you can pick a toolKey and call it immediately.

Where is this flag stored?

• See indexes/packages-list.json entries (e.g. {"validated": true, "tools": { ... } }).

Example: Use a validated package with Vercel AI SDK

Template: const tool = await toolSDK.package('', { ...env }).getAISDKTool('');

// import { generateText } from 'ai';
// import { openai } from '@ai-sdk/openai'
import { ToolSDKApiClient } from 'toolsdk/api';

const toolSDK = new ToolSDKApiClient({ apiKey: process.env.TOOLSDK_AI_API_KEY });
const searchMCP = await toolSDK.package('@toolsdk.ai/tavily-mcp', { TAVILY_API_KEY: process.env.TAVILY_API_KEY });
const searchTool = await searchMCP.getAISDKTool('tavily-search');

// const completion = await generateText({
//   model: openai('gpt-4.1'),
//   messages: [{
//       role: 'user',
//       content: 'Help me search for the latest AI news',
//   }],
//   tools: { searchTool, emailTool },
// });

Available as:

• Docker Image - Full-featured Gateway & Registry
• NPM Package - TypeScript/JavaScript SDK for data access
• Raw Data - JSON endpoints for direct integration

---

Contribute Your MCP Server

Want to add your MCP server to the registry? Check out our Contributing Guide for the full submission process, JSON schema reference, and examples (including remote servers and OAuth 2.1).

---

MCP Servers Directory

4547+ AI Agent Tools, LLM Integrations & Automation Servers

[!NOTE] ⭐ Featured below: Hand-picked, production-ready MCP servers verified by our team.

📚 Looking for all 4547+ servers? Check out All MCP Servers for the complete list.

[!TIP] If a package is marked as validated: true in the index, you can usually wire it up in minutes via ToolSDK (e.g. getAISDKTool(toolKey)).

Browse by category: Developer Tools, AI Agents, Databases, Cloud Platforms, APIs, and more!

Manage Git repositories, pull requests, and issues with version control tools.

• ✅ @kazuph/mcp-github-pera1: Connects to GitHub repositories, enabling natural language queries about code structure, dependencies, and development history. (1 tools) (node)
• ✅ @missionsquad/mcp-github: Integrates with GitHub’s API to enable repository operations, file management, issue tracking, and code search directly within conversations through flexible authentication and over 30 specialized tools. (45 tools) (node)
• ✅ @modelcontextprotocol/server-github: Manage repositories, issues, and search code via GitHub API. (26 tools) (node)
• ✅ @nexus2520/bitbucket-mcp-server: Integrates with Bitbucket Cloud and Server APIs to manage pull request workflows including creation, updates, merging, branch management, code review operations, and diff retrieval with configurable context lines. (16 tools) (node)
• ✅ @sunwood-ai-labs/github-kanban-mcp-server: Integrates with GitHub’s API to enable Kanban-style project management and issue tracking for streamlined software development workflows. (4 tools) (node)
• ✅ @yoda.digital/gitlab-mcp-server: GitLab MCP Server provides robust integration with the GitLab API, enabling developers to interact with repositories, issues, merge requests, and project events through natural language commands via stdio and Server-Sent Events (SSE) transports. (30 tools) (node)
• ✅ git-commands-mcp: Enables Git repository exploration and analysis through a Node.js server that executes commands for cloning repositories, browsing directories, reading files, comparing branches, and searching code patterns with structured JSON responses.