OpenAPI Specification

MCP Director provides a complete OpenAPI 3.0 specification for its HTTP API.

Accessing the Specification

The OpenAPI document is available at:

GET /api-docs

This returns the full OpenAPI 3.0 YAML document.

Using with Swagger UI

You can view the API documentation interactively using Swagger UI:

1. Copy the OpenAPI spec from /api-docs
2. Paste it into Swagger Editor

Download

The OpenAPI specification is also available in the source repository:

• docs/openapi.yaml

API Categories

The specification covers:

• MCP Transport (/sse, /mcp) - JSON-RPC over HTTP
• OAuth/OIDC (/authorize, /token, /register) - Authentication flows
• Admin API (/api/*) - Server management
• Observability (/health, /metrics) - Monitoring endpoints