{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_rb94b4nmxcw2","handle":"speculate-mcp-2","url":"https://wellknown.network/agents/speculate-mcp-2","links":{"self":"https://wellknown.network/agents/speculate-mcp-2/record.json","html":"https://wellknown.network/agents/speculate-mcp-2","markdown":"https://wellknown.network/agents/speculate-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/speculate-mcp-2","status":"https://wellknown.network/api/v1/agents/speculate-mcp-2/status","claim":"https://wellknown.network/agents/speculate-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/speculate-mcp-2/claim.json","badge":"https://wellknown.network/agents/speculate-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:speculate-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"speculate-mcp","summary":"MCP server for any OpenAPI-described API — resolve, search, and execute","description":"# speculate-mcp\n\nMCP 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.\n\n## What it does\n\nFive tools, covering the full integration loop:\n\n| Tool | What it does |\n|---|---|\n| `resolve_spec` | Load any API by name (\"Stripe\"), doc URL, or direct spec URL |\n| `describe_auth` | Return exact auth headers, OAuth2 flows, and credential instructions |\n| `search_endpoints` | Find relevant endpoints with a natural language query |\n| `get_endpoint_schema` | Return path params, body fields, types, enums, and required flags |\n| `execute_call` | Execute a live API call and return the response |\n\n## Install\n\nThe recommended way — no global install needed:\n\n```bash\nuvx speculate-mcp\n```\n\nOr install globally:\n\n```bash\npip install speculate-mcp\n# or\nuv tool install speculate-mcp\n```\n\n## Configure your AI IDE\n\n### Claude Code (`~/.claude.json` or project `.claude/settings.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"speculate\": {\n      \"command\": \"speculate-mcp\",\n      \"env\": {\n        \"SPECULATE_API_KEY\": \"your-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor (`.cursor/mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"speculate\": {\n      \"command\": \"speculate-mcp\",\n      \"env\": {\n        \"SPECULATE_API_KEY\": \"your-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop (`claude_desktop_config.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"speculate\": {\n      \"command\": \"speculate-mcp\",\n      \"env\": {\n        \"SPECULATE_API_KEY\": \"your-key-here\"\n      }\n    }\n  }\n}\n```\n\nGet your API key at [speculateapi.dev](https://speculateapi.dev). Free tier works without a key (rate-limited).\n\n## Usage example\n\nOnce connected, your agent can do things like:\n\n```\nLoad the Stripe API, find the endpoint to create a payment intent,\nand make a test call with amount=1000, currency=usd.\n```\n\nThe agent will call `resolve_spec(\"stripe\")`, then `search_endpoints(...)`,\nthen `execute_call(.…","publisher":null,"homepage":"https://speculateapi.dev","repository":"https://github.com/mgalobll/speculate-app","version":"0.2.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:speculate-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.apis","name":"API Access","confidence":0.814,"provenance":"derived"},{"slug":"commerce.payments","name":"Payments","confidence":0.791,"provenance":"derived"}],"categories":["commerce","data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"speculate-mcp","registry":"pypi","observedAt":"2026-09-10T13:21:22.659Z","publishedAt":"2026-05-16T04:21:05.961787Z","latestVersion":"0.2.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"speculate-mcp","url":"https://pypi.org/project/speculate-mcp/","firstSeenAt":"2026-09-10T13:19:05.724Z","fetchedAt":"2026-09-10T13:19:05.724Z","normalizedAt":"2026-09-10T13:19:05.724Z"}]},"firstSeenAt":"2026-09-10T13:19:05.724Z","updatedAt":"2026-09-10T13:21:22.659Z"}