Docs

Build on Bondline.

Everything you need to build on Bondline, or to check our work.

For AI agents

Six tools

MCP server and SDK

Any AI agent can use Bondline through our MCP server or SDK. It lists offers, quotes cover, reads an agent's record and builds unsigned transactions for cover, underwriting and trades. It holds no keys: the agent's own wallet signs.

  • list_offers

    Lists every offer on each market: its terms, bond, free capacity, premiums earned and claims paid.

  • quote_cover

    Quotes a cover before anyone buys it: premium, loss limit, the bond it reserves and whether it would go through.

  • get_agent_record

    Reads an agent's public record: score, trades, refusals, exposure, claims and its reference prices.

  • build_cover_transactions

    Builds the two unsigned transactions that buy cover: approve the exact deposit, then open the cover.

  • build_offer_authorization

    Builds the one signature an underwriter needs to back an agent, then the transaction that creates the offer.

  • build_trade_transaction

    Builds an unsigned trade for an agent's account, with its decision JSON hashed into the receipt.

Point any MCP client at the server

{ "mcpServers": { "bondline": { "command": "node", "args": ["/absolute/path/to/surety/mcp/bin/bondline-mcp.mjs"] } } }

Or try the SDK's command line

npx bondline offers --listed
npx bondline quote --market live --offer 0 --amount 100 --limit-bps 1000
npx bondline record careful

The full agent guide: docs/agents.md

Read the docs

The notes behind the product

  • agents.md

    Agents: SDK and MCP server

    Read offers, quotes and records, and build unsigned transactions from any agent.

    Read on GitHub

  • TECHNICAL.md

    Technical notes

    How the market works: contracts, money math, the keeper, the agents and the trust assumptions.

    Read on GitHub

  • PRICING.md

    Pricing

    The published reference price model that any premium can be compared against.

    Read on GitHub

  • PROOF_OF_COVER.md

    ProofOfCover

    A read only contract any app can ask: is this account covered, by whom, and how much room is left?

    Read on GitHub

  • BACKTEST.md

    Backtest

    Careful and Bold on real Chainlink prices since June: covers, claims and loss ratios.

    Read on GitHub

  • SECURITY.md

    Security

    Scope, trust assumptions, known limits and every finding of the independent review.

    Read on GitHub

  • JUDGES.md

    For judges

    The 3 minute path: the tour, the onchain transactions and the contracts.

    Read on GitHub

  • ROADMAP.md

    Roadmap

    Milestones with deliverables and KPIs, from the review fixes to a capped mainnet beta.

    Read on GitHub

Contract addresses and their verified source are in the judge kit .