Connect with MCP#

Use this when an MCP-compatible client should call Hightop Agent API tools and receive lifecycle notifications.

Prerequisites#

A Hightop account with an active agent.
An MCP client that supports Streamable HTTP, OAuth, JSON-RPC 2.0, and SSE.
For this page, Claude Desktop is the tested client flow documented publicly.

Claude Desktop#

In Claude Desktop, add a connector and paste:

textexample

https://api.hightop.com/mcp

Claude opens a browser. Complete Hightop OAuth, enter email and OTP, choose the Hightop agent, approve scopes, and return connected.

What the Client Gets#

The MCP tool list is generated from public /v1/agent/* routes and includes inline tools:

mcp_subscribe
mcp_unsubscribe
agent_operations_wait_for_status

For mutating tools, Hightop synthesizes an idempotency key when the caller omits one:

textexample

mcp:<sessionId>:<jsonrpc-id>:<toolName>

Follow Up#

Subscribe to lifecycle events with mcp_subscribe. If your MCP client does not surface notifications/hightop/agent_webhook, call agent_operations_wait_for_status after submitting an operation.

Likely errors: OAuth invalid_token, insufficient_scope, transport 406 for invalid Accept, 429 for session cap saturation.