# Official MCP Registry API

**Canonical:** https://apis.io/apis/agentic-ai-foundation/mcp-registry/  
**Provider:** Agentic AI Foundation — https://apis.io/providers/agentic-ai-foundation/  
**Base URL:** https://registry.modelcontextprotocol.io  
**Documentation:** https://registry.modelcontextprotocol.io/docs

Official MCP Registry API is one of 6 APIs that [Agentic AI Foundation](https://apis.io/providers/agentic-ai-foundation/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include MCP, Registry, Server Discovery, Open Standard, and REST API. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, a GitHub repository, and authentication docs.

The Official MCP Registry is the community registry service for Model Context Protocol servers, run by the MCP project. Its REST API publishes a full OpenAPI 3.1.0 contract with 32 operations across two live version prefixes (/v0.1 and /v0). Reads are anonymous — list, search and fetch server records with cursor pagination and an updated_since incremental-sync filter; writes require a Registry JWT minted by proving namespace ownership through GitHub OAuth, GitHub or generic OIDC, a DNS signature, or an HTTP signature. Errors are RFC 9457 problem details.

## Operations (32)

| Method | Path | Summary |
|---|---|---|
| POST | `/v0.1/auth/dns` | Exchange DNS signature for Registry JWT |
| POST | `/v0.1/auth/github-at` | Exchange GitHub OAuth access token for Registry JWT |
| POST | `/v0.1/auth/github-oidc` | Exchange GitHub OIDC token for Registry JWT |
| POST | `/v0.1/auth/http` | Exchange HTTP signature for Registry JWT |
| POST | `/v0.1/auth/oidc` | Exchange OIDC ID token for Registry JWT |
| GET | `/v0.1/health` | Health check |
| GET | `/v0.1/ping` | Ping |
| POST | `/v0.1/publish` | Publish MCP server |
| GET | `/v0.1/servers` | List MCP servers |
| PATCH | `/v0.1/servers/{serverName}/status` | Update status for all versions of an MCP server |
| GET | `/v0.1/servers/{serverName}/versions` | Get all versions of an MCP server |
| GET | `/v0.1/servers/{serverName}/versions/{version}` | Get specific MCP server version |
| PUT | `/v0.1/servers/{serverName}/versions/{version}` | Edit MCP server |
| PATCH | `/v0.1/servers/{serverName}/versions/{version}/status` | Update MCP server status |
| POST | `/v0.1/validate` | Validate MCP server JSON |
| GET | `/v0.1/version` | Get version information |
| POST | `/v0/auth/dns` | Exchange DNS signature for Registry JWT |
| POST | `/v0/auth/github-at` | Exchange GitHub OAuth access token for Registry JWT |
| POST | `/v0/auth/github-oidc` | Exchange GitHub OIDC token for Registry JWT |
| POST | `/v0/auth/http` | Exchange HTTP signature for Registry JWT |
| POST | `/v0/auth/oidc` | Exchange OIDC ID token for Registry JWT |
| GET | `/v0/health` | Health check |
| GET | `/v0/ping` | Ping |
| POST | `/v0/publish` | Publish MCP server |
| GET | `/v0/servers` | List MCP servers |
| PATCH | `/v0/servers/{serverName}/status` | Update status for all versions of an MCP server |
| GET | `/v0/servers/{serverName}/versions` | Get all versions of an MCP server |
| GET | `/v0/servers/{serverName}/versions/{version}` | Get specific MCP server version |
| PUT | `/v0/servers/{serverName}/versions/{version}` | Edit MCP server |
| PATCH | `/v0/servers/{serverName}/versions/{version}/status` | Update MCP server status |
| POST | `/v0/validate` | Validate MCP server JSON |
| GET | `/v0/version` | Get version information |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/agentic-ai-foundation/refs/heads/main/openapi/agentic-ai-foundation-mcp-registry-openapi.yaml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/agentic-ai-foundation/refs/heads/main/overlays/agentic-ai-foundation-mcp-registry-overlay.yaml
- **APIReference** — https://registry.modelcontextprotocol.io/docs
- **Documentation** — https://github.com/modelcontextprotocol/registry/tree/main/docs
- **GitHubRepository** — https://github.com/modelcontextprotocol/registry
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/agentic-ai-foundation/refs/heads/main/authentication/agentic-ai-foundation-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/agentic-ai-foundation/refs/heads/main/errors/agentic-ai-foundation-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/agentic-ai-foundation/refs/heads/main/data-model/agentic-ai-foundation-data-model.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/agentic-ai-foundation/refs/heads/main/conventions/agentic-ai-foundation-conventions.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/agentic-ai-foundation/refs/heads/main/mcp/agentic-ai-foundation-tool-crosswalk.yml

## Other Agentic AI Foundation APIs (5)

- [Model Context Protocol (MCP)](https://apis.io/apis/agentic-ai-foundation/model-context-protocol/)
- [Goose AI Agent](https://apis.io/apis/agentic-ai-foundation/goose/)
- [AGENTS.md](https://apis.io/apis/agentic-ai-foundation/agents-md/)
- [Agent2Agent (A2A)](https://apis.io/apis/agentic-ai-foundation/agent2agent/)
- [agentgateway](https://apis.io/apis/agentic-ai-foundation/agentgateway/)

## Tags

MCP, Registry, Server Discovery, Open Standard, REST API

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agentic-ai-foundation/mcp-registry/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agentic-ai-foundation/.