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":"swagger-mcp-2","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.
# Swagger MCP Automatically convert a Swagger/OpenAPI specification into an MCP server for use with Windsurf, Cursor, or other tools. ## Quickstart Install from PyPI using pipx (recommended): ```bash brew install pipx pipx ensurepath pipx install --force swagger-mcp ``` Alternatively, install from source: ```bash git clone https://github.com/context-labs/swagger-mcp.git cd swagger-mcp pipx install -e . --force ``` Confirm the installation succeeded: ```bash which swagger-mcp which swagger-mcp-sample-server ``` Spin up a sample "products and product categories" API on your local machine on port 9000: ```bash swagger-mcp-sample-server ``` Visit [http://localhost:9000/docs](http://localhost:9000/docs) to confirm the sample server is running. We'll use this sample server to show how to configure an MCP server in Windsurf. **Make sure the sample server is running before following the Windsurf or Cursor instructions below.** ### Windsurf Start an MCP Server in Windsurf (Windsurf Settings -> Settings -> Windsurf Settings -> Cascade -> Add Server -> Add Custom Server): ```json { "mcpServers": { "product-mcp": { "command": "swagger-mcp", "args": [ "--spec", "http://localhost:9000/openapi.json", "--name", "Product MCP", "--server-url", "http://localhost:9000" ] } } } ``` That's it! Your API is now accessible through Windsurf, Cursor, or other tools as a set of AI-friendly tools. Ask your AI agent to list, create, update, and delete products and categories.  ### Cursor (>=v0.46) Support for Cursor is still in beta as Cursor MCP integration matures. Windsurf is currently the preferred experience. ```json { "mcpServers": { "product mcp": { "command": "swagger-mcp", "args": [ "--spec", "http://localhost:9000/openapi.json", "--name", "Product MCP", "--server-url", "http://localhost:9000", …
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.