ReefAPI MCP

Name: ReefAPI
Author: reefapi

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).

🌐 Homepage: https://reefapi.com
📚 Docs: https://reefapi.com/docs
🔌 MCP guide: https://reefapi.com/mcp
🟢 Status: https://reefapi.com/status

Why one server, not one tool per API

Emitting 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.

Tools

Tool	Keyless	What it does
`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.
`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.
`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.
`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.
`call_engine(engine, action, params)`	🔑	Runs the action and returns the uniform `{ ok, data, meta, error }` envelope.

The intended path is search_engines (or get_catalog) → get_engine_schema → get_action_schema → call_engine.

Connect (remote — recommended)

Add to Claude Desktop, Cursor, Windsurf, or any client that takes a remote MCP URL:

{
  "mcpServers": {
    "reefapi": {
      "url": "https://api.reefapi.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_REEFAPI_KEY" }
    }
  }
}

Claude Code (CLI):

claude mcp add --transport http reefapi https://api.reefapi.com/mcp \
  --header "Authorization: Bearer YOUR_REEFAPI_KEY"

Get a free key (1,000 credits, no card) at https://reefapi.com.

Run it locally (stdio)

pip install -r requirements.txt
export REEFAPI_KEY=ak_live_your_key   # Windows: set REEFAPI_KEY=...
python server.py                      # stdio transport

Then point your client at python /path/to/server.py. The same file also serves the streamable-HTTP transport with MCP_TRANSPORT=streamable-http (used by the hosted endpoint above).

What you can ask

Each example below is answered by one engine; the link goes to that engine's parameters and response shape.

"What are people saying about the new iPhone on Reddit?" → reddit
"Get current Zillow listings in Austin under $500k." → zillow
"Is the domain coolstartup.ai available?" → domain-availability
"Compare Amazon prices for AirPods Pro." → amazon
"Top Hacker News stories right now." → hackernews
"What tech stack does stripe.com run on?" → domain-intel
"Find remote backend jobs posted this week." → global-jobs

You never have to name the engine yourself — that is what search_engines is for. The links are there for when you want to see the exact params and fields before wiring a call.

Coverage

150+ engines across Search/SEO, Social Media, E-commerce, Real Estate, Jobs, Travel, News, Finance, Media/Film, Reputation/Reviews, Company/Domain/People intelligence, and developer utilities. Browse the full catalog at reefapi.com/docs, or call get_catalog() for the live list. A few of the most-used ones:

Engine	Returns
`amazon`	Product search, listing detail, prices, variants and reviews
`ebay`	Listings, item detail and sold/completed pricing
`aliexpress`	Product search and detail, including per-SKU pricing and images
`zillow`	For-sale and rental listings, property detail and value estimates
`redfin`	Listings and market data as a second US real-estate source
`reddit`	Subreddit and keyword search, post detail and comment threads
`bluesky`	Posts, profiles and search across the AT Protocol network
`glassdoor`	Company reviews, ratings and salary data
`trustpilot`	Business profiles and customer reviews with ratings
`indeed`	Job search and posting detail across country sites
`domain-intel`	DNS, WHOIS and detected tech stack for a domain
`news-intel`	Article search and extraction across news sources

Every engine returns the same { ok, data, meta, error } envelope and draws on one shared credit pool.

License

MIT — see LICENSE. The APIs are a hosted service with a free tier; see https://reefapi.com.