Expose OpenAPI endpoints to MCP
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":"glean-mcp-proxy","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.
# OpenAPI MCP Proxy A flexible, production-ready proxy that dynamically exposes OpenAPI-described REST APIs as **Model Context Protocol (MCP) tools**. Automatically keep your MCP surface in sync with any REST API without manual tool definitions. **Author**: David Grimm <david.grimm@wellsfargo.com> --- ## Table of Contents - [Features](#features) - [Quick Start](#quick-start) - [Installation](#installation) - [Configuration](#configuration) - [TOML Format](#toml-format) - [Server Settings](#server-settings) - [OpenAPI Specs](#openapi-specs) - [Path Parameters](#path-parameters) - [Filtering by HTTP Method](#filtering-by-http-method) - [Usage](#usage) - [stdio Transport](#stdio-transport) - [HTTP Transport](#http-transport) - [Framework Selection](#framework-selection) - [Tool Naming and Startup Summary](#tool-naming-and-startup-summary) - [Authentication](#authentication) - [Token-Based Authentication](#token-based-authentication) - [OAuth/JWT Authentication](#oauthjwt-authentication) - [Dual-Mode Authentication](#dual-mode-authentication) - [Roles and RBAC](#roles-and-rbac) - [Disabling Authentication](#disabling-authentication) - [Architecture](#architecture) - [Testing & Coverage](#testing--coverage) - [Troubleshooting](#troubleshooting) - [Development](#development) --- ## Features - **Dynamic Tool Generation** — Automatically create MCP tools from OpenAPI specs - **Multi-Spec Support** — Proxy multiple APIs simultaneously - **Dual Transport** — stdio (default) or HTTP with optional HTTPS/TLS - **Framework Flexibility** — FastMCP or Tachyon MCP (configurable) - **Static & OAuth Auth** — Support both static bearer tokens and JWT/OAuth2 - **Path Parameter Templating** — Set default values per spec - **HTTP Method Filtering** — Expose only specific methods (GET, POST, etc.) - **Readable Tool Names** — Uses OpenAPI `operationId` when available (with clean fallback naming) - **Startup Tool Summary** — Logs per-spec …
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.