Documentation Index
Fetch the complete documentation index at: https://docs.supersonic.cv/llms.txt
Use this file to discover all available pages before exploring further.
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
}
{
"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
| Code | HTTP Status | Meaning |
|---|
validation_error | 400 | Invalid parameters |
permission_denied | 403 | Insufficient role |
tool_not_found | 404 | Tool doesn’t exist |
subscription_required | 403 | Trial expired |
Rate limits
1,000 calls per minute per API key. See Rate Limits.