call_engine
Call a ReefAPI engine action — POST //v1/ 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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"engine": "<engine>",
"action": "<action>"
},
"name": "call_engine"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | The action to run on that engine (e.g. 'search'), as listed by get_engine_schema. | |
| engine | Yes | The engine's name to call (e.g. 'zillow'), as returned by search_engines or get_catalog. | |
| params | No | The action's parameters as a JSON object, e.g. {'query': 'NYC'}. Get the valid param names and values from get_action_schema first. Omit or pass null for actions that take none. |