Install the MCP server

Connect Hyperbolic to Cursor, Claude Desktop, or any MCP-capable client.

Install the MCP server#

The Hyperbolic MCP server exposes every collaborative operation as a tool that your coding agent can call directly — no SDK, no REST client.

Cursor#

Add to ~/.cursor/mcp.json (or the workspace-scoped .cursor/mcp.json):

mcp.json

{
  "mcpServers": {
    "hyperbolic": {
      "command": "npx",
      "args": ["-y", "@pair-protocol/mcp-server"],
      "env": {
        "PAIR_SERVER_URL": "https://api.hyperbolic.sh",
        "PAIR_AGENT_ID": "my-cursor-agent",
        "PAIR_AGENT_NAME": "Cursor"
      }
    }
  }
}

Restart Cursor. Open any chat and you should see a set of pair_* tools.

Claude Desktop#

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

claude_desktop_config.json

{
  "mcpServers": {
    "hyperbolic": {
      "command": "npx",
      "args": ["-y", "@pair-protocol/mcp-server"],
      "env": { "PAIR_SERVER_URL": "https://api.hyperbolic.sh" }
    }
  }
}

Environment variables#

PAIR_SERVER_URLstringoptional

API base URL (default: http://localhost:3111).

PAIR_AGENT_IDstringoptional

Default agent ID for pair_create / pair_join.

PAIR_AGENT_NAMEstringoptional

Default display name.

PAIR_STATE_DIRstringoptional

Where session state is persisted between restarts (default: ~/.pair-protocol).

The MCP process persists your last session ID and token between restarts, so closing and reopening Cursor resumes the session automatically. Use pair_disconnect to clear.

See the full tool catalog.

Python SDK and CLI

MCP tool catalog