Skip to main content
POST
Python

Authorizations

Authorization
string
header
required

An Onecortex API key, oc_live_..., from API keys in the dashboard, or an access token, oc_oat_..., that an app received when a person allowed it to use one agent.

Headers

MCP-Protocol-Version
string
required

2026-07-28, equal to the version in the request's _meta. A 2025-11-25 client sends it after initialize.

Example:

"2026-07-28"

Mcp-Method
string
required

The JSON-RPC method, as in the body.

Example:

"tools/call"

Mcp-Name
string

The tool's name, on tools/call.

Example:

"ask_echo"

Path Parameters

agentId
string
required

The agent's ID, from its page in the dashboard.

Example:

"agt_01K0000000000000000000000"

Body

application/json
jsonrpc
any
required
method
string
required
Example:

"SendMessage"

id
params
object

Response

A JSON-RPC response, or a stream of progress notifications ending with it.

jsonrpc
any
required
id
result
object

For SendMessage on 1.0, an object holding task.

error
object
Last modified on September 30, 2026