For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt, and this page is available as Markdown at /en/api/agent-mcp.md.
  • English
  • 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.

    Experts in the web UI

    Experts

    Endpoint (Streamable HTTP):

    POST /api/mcp/agents
    GET  /api/mcp/agents
    DELETE /api/mcp/agents

    Prefer HTTPS when the URL is reachable outside the local machine. Access tokens last 24 hours by default.

    Tools

    ToolWhat it does
    list_octop_expertsLists experts you can see
    call_octop_expertStarts a new isolated conversation, or continues one when you pass thread_id
    resume_octop_expertContinues a call that stopped for tool approval or a user question

    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

    {
      "mcpServers": {
        "octop-agents": {
          "type": "streamable_http",
          "url": "http://127.0.0.1:8088/api/mcp/agents",
          "headers": {
            "Authorization": "Bearer <octop-access-token>"
          }
        }
      }
    }

    Some MCP clients use http instead of streamable_http. Get a token with Authentication.

    • Agents API — manage experts over REST
    • Connectors — connect external MCP tool servers into Octop (the opposite direction)