Smithery Registry OpenAPI Server

What is Smithery Registry OpenAPI Server?

Smithery Registry OpenAPI Server provides an OpenAPI-compliant interface to the Smithery Registry API, enabling users to search, list, and obtain launch configurations for Model Context Protocol (MCP) servers. It requires bearer token authentication and is designed for developers integrating MCP servers via OpenAPI tools or the Smithery SDK.

How to use Smithery Registry OpenAPI Server?

Install dependencies with pip install -r requirements.txt and run the server using uvicorn main:app --host 0.0.0.0 --port 8000 --reload. Authenticate all requests by including a bearer token in the Authorization header. Use the API endpoints to search servers, get details, or generate WebSocket URLs.

Key features of Smithery Registry OpenAPI Server

• List MCP servers with advanced filtering support
• Get detailed server information and connection configurations
• Generate WebSocket URLs with base64-encoded configs
• Bearer token authentication for all requests
• Compatible with any OpenAPI-compliant tools
• Query parameters for search, pagination, and filtering

Use cases of Smithery Registry OpenAPI Server

• Discovering MCP servers by owner, repository, or text search
• Retrieving detailed configuration schemas for a specific server
• Generating secure WebSocket URLs to connect to MCP servers programmatically
• Automating server selection and connection in CI/CD pipelines
• Using OpenAPI tools like Swagger UI to explore the registry

FAQ from Smithery Registry OpenAPI Server

What authentication is required?

All requests must include a bearer token in the Authorization header (format: Bearer your-api-token). Obtain a token from your Smithery user profile under API keys.

How do I start the server?

Install dependencies with pip install -r requirements.txt and run uvicorn main:app --host 0.0.0.0 --port 8000 --reload. The server will be available at http://localhost:800