MCP server for any OpenAPI-described API — resolve, search, and execute
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":"speculate-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.
# speculate-mcp MCP server for any OpenAPI-described API. Gives AI agents the ability to resolve, explore, and execute calls against any REST API with an OpenAPI spec — without writing custom integration code. ## What it does Five tools, covering the full integration loop: | Tool | What it does | |---|---| | `resolve_spec` | Load any API by name ("Stripe"), doc URL, or direct spec URL | | `describe_auth` | Return exact auth headers, OAuth2 flows, and credential instructions | | `search_endpoints` | Find relevant endpoints with a natural language query | | `get_endpoint_schema` | Return path params, body fields, types, enums, and required flags | | `execute_call` | Execute a live API call and return the response | ## Install The recommended way — no global install needed: ```bash uvx speculate-mcp ``` Or install globally: ```bash pip install speculate-mcp # or uv tool install speculate-mcp ``` ## Configure your AI IDE ### Claude Code (`~/.claude.json` or project `.claude/settings.json`) ```json { "mcpServers": { "speculate": { "command": "speculate-mcp", "env": { "SPECULATE_API_KEY": "your-key-here" } } } } ``` ### Cursor (`.cursor/mcp.json`) ```json { "mcpServers": { "speculate": { "command": "speculate-mcp", "env": { "SPECULATE_API_KEY": "your-key-here" } } } } ``` ### Claude Desktop (`claude_desktop_config.json`) ```json { "mcpServers": { "speculate": { "command": "speculate-mcp", "env": { "SPECULATE_API_KEY": "your-key-here" } } } } ``` Get your API key at [speculateapi.dev](https://speculateapi.dev). Free tier works without a key (rate-limited). ## Usage example Once connected, your agent can do things like: ``` Load the Stripe API, find the endpoint to create a payment intent, and make a test call with amount=1000, currency=usd. ``` The agent will call `resolve_spec("stripe")`, then `search_endpoints(...)`, then `execute_call(.…
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.