Skip to main content
POST
MCP server (Streamable HTTP)

Authorizations

Authorization
string
header
required

A Custral API key, created in Settings → Developers → Applications, sent as Authorization: Bearer sk_…. The X-Api-Key header is also accepted and takes precedence. Use a secret key (sk_…) from your server; a publishable key (pk_…) may hold only objects:read and usage:write. Never expose a secret key in a browser.

Headers

Accept
string
required

Must list both application/json and text/event-stream, or the server answers 406.

Body

application/json

A JSON-RPC 2.0 message (or send an array of them).

jsonrpc
enum<string>
required
Available options:
2.0
method
string
required

An MCP method: initialize, tools/list, tools/call, …

Example:

"tools/list"

id

Omit for a notification.

params
object

Response

A server-sent event stream carrying the JSON-RPC response (each data: line is one message).

A JSON-RPC 2.0 response: result on success, error on failure.

jsonrpc
enum<string>
required
Available options:
2.0
id
result
object
error
object