MCP server that exposes OpenAPI specifications as queryable documentation resources for LLMs, with Scalar deep links and semantic search
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"caitlyn-openapi-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Caitlyn OpenAPI MCP Server MCP server that exposes OpenAPI specifications as queryable documentation resources for LLMs, with Scalar deep links. ## Features - **URL-based OpenAPI spec loading**: Load specs from any URL, not just local files - **$ref resolution**: Automatically resolves all `$ref` references (including remote refs) using Prance - **Semantic search**: Vector-based endpoint search using sentence-transformers for better query understanding - **Scalar deep links**: Every endpoint, schema, and security scheme includes a `docs_url` pointing to Scalar documentation - **MCP resources**: Expose spec structure for introspection - **MCP tools**: Search and query endpoints, schemas, and security schemes - **Streamable HTTP**: Built for Bedrock AgentCore integration ## Installation ### Using uvx (recommended) For isolated execution without global installation: ```bash uvx caitlyn-openapi-mcp ``` ### Using pip Install from PyPI: ```bash pip install caitlyn-openapi-mcp ``` ### From source For local development or testing: ```bash git clone https://github.com/caitlyn-ai/caitlyn-openapi-mcp.git cd caitlyn-openapi-mcp pip install -e ".[dev]" ``` ## Configuration The server is configured via environment variables: ### Required - `OPENAPI_SPEC_URL`: Full URL to the OpenAPI JSON/YAML specification - Example: `https://api.example.com/openapi.json` - Example: `https://raw.githubusercontent.com/org/repo/main/openapi.yaml` ### Optional - `DOCS_RENDERER`: Documentation renderer type (default: `"scalar"`) - Currently only `"scalar"` is supported - `DOCS_BASE_URL`: Base URL of the Scalar documentation UI - Example: `https://api.example.com/docs` - Example: `https://api.example.com/scalar` - If not provided, `docs_url` fields will be `null` - `MCP_TRANSPORT`: Transport mode (default: `"stdio"`) - `"stdio"`: For local development and Claude Desktop (default) - `"streamable-http"`: For AWS Bedrock AgentCore deployment ### OpenTelemetry (O…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.