{ "markdown": "# ReefAPI MCP\n\n\n \"ReefAPI\n\n\n**One MCP server for 150+ live web-data APIs** — search engines, social media, e-commerce, real estate, jobs, travel, news, finance, and company/domain/people intelligence. The assistant discovers the right engine, then pulls clean JSON from sites that block scrapers (captcha, login, JS, anti-bot).\n\n- 🌐 **Homepage:** https://reefapi.com\n- 📚 **Docs:** https://reefapi.com/docs\n- 🔌 **MCP guide:** https://reefapi.com/mcp\n- 🟢 **Status:** https://reefapi.com/status\n\n## Why one server, not one tool per API\n\nEmitting one tool per API blows past the ~30–50-tool ceiling where agents stop picking the right tool. ReefAPI uses dynamic discovery instead: **five generic tools** let the assistant find the right engine, then call it. Discovery is keyless; only `call_engine` needs a key. **Failed or blocked calls cost nothing.**\n\n## Tools\n\n| Tool | Keyless | What it does |\n|---|---|---|\n| `search_engines(query)` | ✅ | Ranks the catalog against English keywords or a short use-case (\"company reviews\", \"is this domain free\") and returns the best-matching engines with their actions. |\n| `get_catalog()` | ✅ | Returns the full menu — every engine with a one-line title, grouped by category — so the model can pick semantically when a keyword search misses. |\n| `get_engine_schema(engine)` | ✅ | Compact overview of one engine: each action with its description, required params, and return shape, kept lean so a large engine stays token-cheap. |\n| `get_action_schema(engine, action)` | ✅ | Full detail for a single action: every parameter with type, allowed values, default, example, plus pricing and ready-to-run example params. |\n| `call_engine(engine, action, params)` | 🔑 | Runs the action and returns the uniform `{ ok, data, meta, error }` envelope. |\n\nThe intended path is `search_engines` (or `get_catalog`) → `get_engine_schema` → `get_action_schema` → `call_engine`.\n\n## Connect (remote — recommended)\n\nAdd to Claude Desktop, Cursor, Windsurf, or any client that takes a remote MCP URL:\n\n```json\n{\n \"mcpServers\": {\n \"reefapi\": {\n \"url\": \"https://api.reefapi.com/mcp\",\n \"headers\": { \"Authorization\": \"Bearer YOUR_REEFAPI_KEY\" }\n }\n }\n}\n```\n\nClaude Code (CLI):\n\n```bash\nclaude mcp add --transport http reefapi https://api.reefapi.com/mcp \\\n --header \"Authorization: Bearer YOUR_REEFAPI_KEY\"\n```\n\nGet a **free key (1,000 credits, no card)** at https://reefapi.com.\n\n## Run it locally (stdio)\n\n```bash\npip install -r requirements.txt\nexport REEFAPI_KEY=ak_live_your_key # Windows: set REEFAPI_KEY=...\npython server.py # stdio transport\n```\n\nThen point your client at `python /path/to/server.py`. The same file also serves the streamable-HTTP\ntransport with `MCP_TRANSPORT=streamable-http` (used by the hosted endpoint above).\n\n## What you can ask\n\nEach example below is answered by one engine; the link goes to that engine's parameters and response shape.\n\n- *\"What are people saying about the new iPhone on Reddit?\"* → [`reddit`](https://reefapi.com/docs/reddit)\n- *\"Get current Zillow listings in Austin under $500k.\"* → [`zillow`](https://reefapi.com/docs/zillow)\n- *\"Is the domain `coolstartup.ai` available?\"* → [`domain-availability`](https://reefapi.com/docs/domain-availability)\n- *\"Compare Amazon prices for AirPods Pro.\"* → [`amazon`](https://reefapi.com/docs/amazon)\n- *\"Top Hacker News stories right now.\"* → [`hackernews`](https://reefapi.com/docs/hackernews)\n- *\"What tech stack does stripe.com run on?\"* → [`domain-intel`](https://reefapi.com/docs/domain-intel)\n- *\"Find remote backend jobs posted this week.\"* → [`global-jobs`](https://reefapi.com/docs/global-jobs)\n\nYou never have to name the engine yourself — that is what `search_engines` is for. The links are there for\nwhen you want to see the exact params and fields before wiring a call.\n\n## Coverage\n\n150+ engines across Search/SEO, Social Media, E-commerce, Real Estate, Jobs, Travel, News, Finance,\nMedia/Film, Reputation/Reviews, Company/Domain/People intelligence, and developer utilities.\nBrowse the full catalog at [reefapi.com/docs](https://reefapi.com/docs), or call `get_catalog()` for the\nlive list. A few of the most-used ones:\n\n| Engine | Returns |\n|---|---|\n| [`amazon`](https://reefapi.com/docs/amazon) | Product search, listing detail, prices, variants and reviews |\n| [`ebay`](https://reefapi.com/docs/ebay) | Listings, item detail and sold/completed pricing |\n| [`aliexpress`](https://reefapi.com/docs/aliexpress) | Product search and detail, including per-SKU pricing and images |\n| [`zillow`](https://reefapi.com/docs/zillow) | For-sale and rental listings, property detail and value estimates |\n| [`redfin`](https://reefapi.com/docs/redfin) | Listings and market data as a second US real-estate source |\n| [`reddit`](https://reefapi.com/docs/reddit) | Subreddit and keyword search, post detail and comment threads |\n| [`bluesky`](https://reefapi.com/docs/bluesky) | Posts, profiles and search across the AT Protocol network |\n| [`glassdoor`](https://reefapi.com/docs/glassdoor) | Company reviews, ratings and salary data |\n| [`trustpilot`](https://reefapi.com/docs/trustpilot) | Business profiles and customer reviews with ratings |\n| [`indeed`](https://reefapi.com/docs/indeed) | Job search and posting detail across country sites |\n| [`domain-intel`](https://reefapi.com/docs/domain-intel) | DNS, WHOIS and detected tech stack for a domain |\n| [`news-intel`](https://reefapi.com/docs/news-intel) | Article search and extraction across news sources |\n\nEvery engine returns the same `{ ok, data, meta, error }` envelope and draws on one shared credit pool.\n\n## License\n\nMIT — see [LICENSE](LICENSE). The APIs are a hosted service with a free tier; see https://reefapi.com.\n", "bytes": 5925, "sha": "ebaf26b046a2bd5c29cebb0556e7f826e756c3fc54249e2ceb7a9c78394c5acd", "repo_slug": "reefapi/reefapi-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_reefapi_reefapi_mcp_7fc3d9c4/readme" }