Skip to main content
POST
/
api
/
v1
/
mcp
/
tenants
/
{tenantId}
/
bots
MCP bots endpoint (Streamable HTTP)
curl --request POST \
  --url https://platform.crescendo.ai/api/v1/mcp/tenants/{tenantId}/bots \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "tools",
  "method": "tools/list"
}
'
{
  "jsonrpc": "<string>",
  "id": "<string>",
  "result": {},
  "error": {}
}
This endpoint exposes the Bots MCP server over Streamable HTTP. Requests and responses use JSON-RPC 2.0. If you are building an MCP client, prefer using an MCP SDK. If you need to call the endpoint directly, you can use the examples below.

​
Example: list available tools

export CRESCENDO_TENANT_ID="tenant-alpha"
export CRESCENDO_API_KEY="YOUR_API_KEY"

curl -sS -X POST \
  -H "Authorization: Bearer $CRESCENDO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":"tools","method":"tools/list"}' \
  "https://platform.crescendo.ai/api/v1/mcp/tenants/$CRESCENDO_TENANT_ID/bots"

​
Example: call a tool (list_bots)

curl -sS -X POST \
  -H "Authorization: Bearer $CRESCENDO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":"call-1","method":"tools/call","params":{"name":"list_bots","arguments":{"limit":50}}}' \
  "https://platform.crescendo.ai/api/v1/mcp/tenants/$CRESCENDO_TENANT_ID/bots"

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
tenantId
string
required

Tenant identifier.

Body

application/json
​
jsonrpc
string
required
Allowed value: "2.0"
​
method
string
required
​
id
​
params
object | null

Response

JSON-RPC response

​
jsonrpc
string
required
Allowed value: "2.0"
​
id
​
result
object | null
​
error
object | null