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.
Access
Section titled “Access”- 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 withproducer_emailon 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.
Connect it
Section titled “Connect it”| Environment | Connector URL |
|---|---|
| Production | https://mcp.hedgespecialty.com/mcp |
| Sandbox | https://sandbox-mcp.hedgespecialty.com/mcp |
-
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.tomlentry (via themcp-remotebridge).
-
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.
-
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”.
Manage and revoke access
Section titled “Manage and revoke access”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.