Call Octop experts from other programs (Agent MCP)
Other programs can call your installed Octop experts through the Agent MCP gateway. You authenticate with the same JWT you use for the REST API. There is no separate dashboard page for this gateway — configure your MCP client with the URL below, then manage experts as usual in the web UI.

Endpoint (Streamable HTTP):
Prefer HTTPS when the URL is reachable outside the local machine. Access tokens last 24 hours by default.
Tools
call_octop_expert returns a thread_id. Store it in the external agent’s state. Pass it only when the next task must reuse that Octop conversation. Omit it for a new task.
MCP threads stay separate from web UI, CLI, and IM threads. You cannot attach an MCP call to an existing dashboard conversation.
Approvals
If a tool needs approval, the call returns status: "approval_required" and an approval object. Read approval.request.action_requests and approval.request.review_configs, then send one allowed decision per action to resume_octop_expert. A resumed call can ask for approval again.
Example client config
Some MCP clients use http instead of streamable_http. Get a token with Authentication.
Related
- Agents API — manage experts over REST
- Connectors — connect external MCP tool servers into Octop (the opposite direction)

