MCP Connector

The Hedge MCP connector is a read-only Model Context Protocol server. Connect it to an AI tool and the assistant can read your Hedge book to answer questions, without any ability to change data or send anything on your behalf.

What it can read

Submissions

Status, readiness, and details of the risks you have in market.

Policies

Your bound policies and their key terms.

Payments

Commission payments and payout status.

Appetite

Which markets want a class of business, and what they need to quote.

Note

The connector is read-only. It uses the broker_mcp scope, which grants read access only. To create or change anything, use the CLI or REST API with the broker_submit scope.

Connect it

The connector works with any MCP-capable client, including Claude, ChatGPT, Cursor, and Claude Code.

1. Copy the connector URL. Find the Hedge connector URL in the broker portal under Settings, Connected apps.

2. Add it to your AI tool. Paste the URL into your client’s connector or MCP server settings:

   • Claude and Claude Code: add it as a custom connector.
   • ChatGPT: add it as a connector.
   • Cursor: add it as an MCP server.

3. Sign in and approve. The tool opens the broker portal. Sign in and approve the connection. Access is scoped to your brokerage and read-only.

4. Ask away. The assistant can now answer questions like “which of my submissions are waiting on the carrier” or “what did I get paid last month”, reading live data from Hedge.

Manage and revoke access

Every connected tool shows up as a connected app. Manage or revoke them any time under Settings, Connected apps in the broker portal. You can revoke a single connection or disconnect everything at once. A revoked tool has to go back through the approval screen if it reconnects.

The connector authenticates with OAuth 2.1, the same model the CLI and API use. See Authentication for details.