Skip to main content
All 62 tools are available through one endpoint. Send the tool name and parameters as JSON, get the result back.

​
Endpoint

POST https://mcp.supersonic.cv/api/developers/mcp/call/
Authorization: Bearer supersonic_live_YOUR_KEY
Content-Type: application/json

​
Request

{
  "tool": "records.list",
  "params": {
    "object_type_slug": "contacts",
    "page_size": 10
  }
}

​
Response

On success, the tool result is returned directly: 
{
  "items": [...],
  "total": 42,
  "page": 1
}
On error: 
{
  "error": "Record not found",
  "code": "validation_error"
}

​
Examples

import httpx

API_KEY = "supersonic_live_YOUR_KEY"
URL = "https://mcp.supersonic.cv/api/developers/mcp/call/"

def call(tool, params={}):
    r = httpx.post(URL, headers={"Authorization": f"Bearer {API_KEY}"}, json={"tool": tool, "params": params})
    r.raise_for_status()
    return r.json()

contacts = call("records.list", {"object_type_slug": "contacts"})
deal = call("records.create", {"object_type_slug": "deals", "data": {"name": "Acme Deal", "value": 50000}})
results = call("records.search", {"query": "Acme"})

​
Error codes

CodeHTTP StatusMeaning
validation_error400Invalid parameters
permission_denied403Insufficient role
tool_not_found404Tool doesn’t exist
subscription_required403Trial expired

​
Rate limits

1,000 calls per minute per API key. See Rate Limits.