Skip to content

MCP Connector

The Hedge MCP connector is a Model Context Protocol server for your brokerage’s book at Hedge. Connect it to an AI tool and the assistant can quote Hedge Instant Quote markets for you: check appetite, ask you each question once, create the file, request quotes, show you the quotes and PDFs, and hand you the bind link. It reads your book too. Everything is scoped to your own brokerage.

For the workflow and the rules an agent should follow, with a worked example and the Hedge skill for Claude, see the Agents guide.

The flow tools:

Tool What it does Access
check_instant_appetite Which instant markets fit, or email_us when none does. read
get_questions The chosen markets’ questions merged by canonical key, so each is asked once, with each question’s markets. The raw per-market form on request. read
create_submission Creates the file; takes the merged answers and fills every market. Instant Quote markets only. submit
answer Answers the gaps, by canonical key or per market. submit
request_quotes Requests quotes for the ready markets. submit
get_status Where each market on a file stands, with what is missing and what Hedge suggests. Poll it while a market is preparing or quoting. read
get_quotes The itemized quotes with their PDF links. read
get_bind_link The bind link for a quote. submit

The read tools for your submissions, markets, policies, payments, programs and book stay available, as do upload_document (attach a PDF to a file) and set_market_access (turn a market, program or line on or off for your brokerage).

Retired: the earlier create_submission, finalize_submission, get_submission_requirements, save_carrier_answers, request_carrier_quote, get_carrier_quote_request, request_bind and get_bind_request. The flow tools above replace them.

  • Read comes with every connection (broker_mcp).
  • Submit needs both the write access you approve at connect time (broker_submit) and submit access on your brokerage, which Hedge turns on. Without it the submit tools are refused; the agent should stop and tell you rather than retry.
  • API keys work too, for agents that run without a person signing in: exchange the key with client_credentials, send the token as a bearer, and name the producing broker with producer_email on every write.
  • Agent write access under Settings → Connected apps turns every connected tool read-only at once.

A connected agent should show you the exact action before a write and wait for your approval.

Environment Connector URL
Production https://mcp.hedgespecialty.com/mcp
Sandbox https://sandbox-mcp.hedgespecialty.com/mcp
  1. Add the URL to your AI tool. The URL is also under Settings → Integrations in the broker portal.

    • Claude and Claude Code: add it as a custom connector.
    • ChatGPT: add it as a connector.
    • Cursor: add it as an MCP server.
    • Codex: the Integrations pane shows the config.toml entry (via the mcp-remote bridge).
  2. Sign in and approve. The tool opens the broker portal. Sign in and approve the connection. Write access is a separate line you can decline for a read-only connection.

  3. Ask. “Can Hedge instant-quote GL for a landscaper in Sacramento?”, “quote this risk and show me the prices”, “get me the bind link for the Coterie quote”.

Every connected tool shows up under Settings → Connected apps in the broker portal. Revoke a single connection or disconnect everything at once; a revoked tool goes back through the approval screen if it reconnects. See Authentication for the OAuth model.