> For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt.

# 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](/images/en/ui-agents.png "Experts")

Endpoint (Streamable HTTP):

```text
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

| Tool                  | What it does                                                                   |
| --------------------- | ------------------------------------------------------------------------------ |
| `list_octop_experts`  | Lists experts you can see                                                      |
| `call_octop_expert`   | Starts a new isolated conversation, or continues one when you pass `thread_id` |
| `resume_octop_expert` | Continues 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

```json
{
  "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](/en/api/authentication.md).

## Related

- [Agents API](/en/api/agents.md) — manage experts over REST
- [Connectors](/en/api/connectors.md) — connect external MCP tool servers _into_ Octop (the opposite direction)

***
