MCP Server that creates tools from OpenAPI/Swagger specifications
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":"mcp-this-openapi","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.
# mcp-this-openapi [](https://github.com/shane-kercheval/mcp-this-openapi/actions/workflows/tests.yaml) [](https://www.python.org/downloads/) [](https://opensource.org/licenses/Apache-2.0) A Model Context Protocol (MCP) server that automatically generates tools from OpenAPI/Swagger specifications, allowing MCP Clients (e.g. Claude Desktop) to interact with any REST API. ## Features - 🔄 **Automatic Tool Generation**: Converts OpenAPI specs into callable MCP tools - 🔐 **Multiple Authentication Types**: Bearer tokens, API keys, Basic auth, or no auth - 🎯 **Path Filtering**: Include/exclude specific API endpoints using regex patterns - 🌐 **Flexible Spec Loading**: Supports both JSON and YAML OpenAPI specifications - 🔒 **Environment Variables**: Secure credential management with `${VAR_NAME}` expansion - 🛡️ **Secure by Default**: Only GET (read-only) operations enabled by default ## Quick Start ### Minimal Usage The easiest way to get started is with a simple command line argument: **1. Configure Claude Desktop** Add this to your Claude Desktop `claude_desktop_config.json`: ```json { "mcpServers": { "petstore": { "command": "uvx", "args": [ "mcp-this-openapi", "--openapi-spec-url", "https://petstore3.swagger.io/api/v3/openapi.json" ] } } } ``` **2. Try it in Claude** Once configured, you can ask Claude things like: - "What pet operations are available?" - "Get information about pet with ID 1" - "Show me the pet store inventory" **🔒 Security Note**: By default, only `GET` (read-only) operations are enabled for safety. ### Advanced Usage (Configuration File) For authentication, filtering, or other advanced features, create a YAML configuration file: *…
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.