Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "reefapi-mcp": {
      "type": "http",
      "url": "https://api.reefapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${REEFAPI_MCP_TOKEN}"
      }
    }
  }
}

claude mcp add --transport http reefapi-mcp https://api.reefapi.com/mcp --header "Authorization: Bearer ${REEFAPI_MCP_TOKEN}"

[mcp_servers.reefapi-mcp]
url = "https://api.reefapi.com/mcp"
bearer_token_env_var = "REEFAPI_MCP_TOKEN"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "reefapi-mcp": {
      "type": "remote",
      "url": "https://api.reefapi.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:REEFAPI_MCP_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "reefapi-mcp": {
      "type": "http",
      "url": "https://api.reefapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${REEFAPI_MCP_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=reefapi-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLnJlZWZhcGkuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke1JFRUZBUElfTUNQX1RPS0VOfSJ9fQ%3D%3D"
}

{
  "servers": {
    "reefapi-mcp": {
      "type": "http",
      "url": "https://api.reefapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${REEFAPI_MCP_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "reefapi-mcp": {
      "httpUrl": "https://api.reefapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${REEFAPI_MCP_TOKEN}"
      }
    }
  }
}

extensions:
  "reefapi-mcp":
    enabled: true
    name: "reefapi-mcp"
    type: streamable_http
    uri: "https://api.reefapi.com/mcp"
    headers:
      "Authorization": "Bearer ${REEFAPI_MCP_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${REEFAPI_MCP_TOKEN}. The registry never accepts secret values.

Quality 85 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations5 of 5 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search_engines (destructiveHint); get_engine_schema (destructiveHint); get_action_schema (destructiveHint); …
pass
tools.token_costabout 1,296 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

5 tools, about 1,296 tokens to load them all · tool set 830afd98cad0 · checked 2026-10-20 10:03 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 93 / 100

provenance90

liveness98

freshness85

hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-95% ~updated-53d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://api.reefapi.com/mcp` streamable-http	api_key `${REEFAPI_MCP_TOKEN}`	yes	95%	561 ms	2025-11-25	2026-10-20

Tools (5)

`call_engine`	Call a ReefAPI engine action — POST /<engine>/v1/<action> with `params`. Returns the uniform { ok, data, meta, error } envelope. Get param names from get_engine_schema first. Needs YOUR ReefAPI key. The local server reads REEFAPI_KEY; the hosted server accepts an OAuth access token (connect with OAuth and paste your key once on the consent screen — this is what ChatGPT uses), an `Authorization: Bearer <key>` header, `x-reefapi-key`, or the key in the connection URL (`https://api.reefapi.com/mcp?key=<key>`). Get a key at https://reefapi.com. Failed calls cost no credits.
`get_action_schema`read-only	FULL detail for ONE engine action: every parameter (type, required, description, allowed_values dropdown, default, example, min/max), what it returns, pricing, and a ready-to-run example_params. Call this right before call_engine so you send valid params — invalid enum values are rejected with the allowed list.
`get_catalog`read-only	The FULL ReefAPI catalog — EVERY engine with its one-line title, grouped by category. This is the whole menu (≈ a few thousand tokens); SCAN IT AND PICK THE BEST ENGINE YOURSELF. You are an LLM, so you match the user's intent semantically — across ANY language, typo, or phrasing — far better than a keyword search can. Use this whenever search_engines didn't surface the right engine (or to be sure you didn't miss a better one). After you pick: get_engine_schema(engine) -> get_action_schema -> call_engine.
`get_engine_schema`read-only	COMPACT overview of ONE engine: every action with its description, required params and what it returns — but NOT the full param detail (kept lean so a 90-action engine stays token-cheap). Call this after search_engines to pick the right ACTION, then get_action_schema(engine, action) for that action's full params before call_engine.
`search_engines`read-only	Find the right ReefAPI engine for a task — pass ENGLISH keywords or a short natural-language use-case ("detect a website's tech stack", "company reviews", "check a package for vulnerabilities", "is this domain available"). The catalog is in English: if the end-user asked in another language, translate their INTENT into English keywords first (you are an LLM — do this inline). Ranks engines by how well the query matches each engine's name/title/category/ACTION descriptions (stem-matched, so plurals/word-forms still hit). Empty query = list all. Returns name/title/category/actions + match score. Call this FIRST, then get_engine_schema(engine) to pick an action. This is a fast keyword pre-filter — if the right engine isn't in the results (or you want to be sure), call get_catalog and pick from the full list YOURSELF (you semantically match any language/phrasing better than keywords).

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.reefapi/reefapi-mcp",
  "icons": [
    {
      "src": "https://reefapi.com/icon.svg",
      "sizes": [
        "any"
      ],
      "mimeType": "image/svg+xml"
    }
  ],
  "title": "ReefAPI",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://api.reefapi.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer <your ReefAPI key from reefapi.com>"
        }
      ]
    }
  ],
  "version": "1.27.2",
  "repository": {
    "url": "https://github.com/reefapi/reefapi-mcp",
    "source": "github"
  },
  "websiteUrl": "https://reefapi.com/mcp",
  "description": "One MCP server for 180+ live web-data APIs returning clean JSON from sites that block scrapers."
}