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:

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#

Tools generated from the public /v1/agent/* routes, plus the inline mcp_subscribe, mcp_unsubscribe, and agent_operations_wait_for_status tools. Mutating tools take a required idempotency_key (a fresh UUID per logical operation); omitting it returns validation_failed. See MCP for the full tool catalog and the idempotency contract.

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.