Developer & Agent API

Cover Raccoon API

DeFi cover analyses as clean, read-only HTTP endpoints, completely free: does a cover product actually pay for the risk it is sold against. Use this when your user is deciding whether to trust a DeFi cover product. The full written analysis (category-score reasoning, claims history, capital adequacy, sources) and the cover purchase flow live on the website only, at coverraccoon.com/cover/{provider}/{product}.

Free, read-only No auth, no payment 20 requests/min per IP

GET /api/cover/v1/analyses

Catalog of every scored cover: score, band, audience, red flags, premium.

GET /api/cover/v1/analyses/{provider}/{product}/check

Does this cover actually pay for my risk? Clause-by-clause gap map, signed.

GET /api/cover/v1/schema

Response shape of the two endpoints above, placeholder-filled.

Same, as an MCP server: coverraccoon-mcp

cover_list reads /v1/analyses

cover_check reads /v1/…/check

The full written analysis and the purchase flow stay on the website only, behind the paywall.

Quickstart

Fastest path for an AI agent: add the MCP server to your host and ask it about a cover. No API key needed.

Add the server to your host config (Claude Desktop, Cursor, or any MCP host):

{
  "mcpServers": {
    "coverraccoon": {
      "command": "npx",
      "args": ["-y", "coverraccoon-mcp"]
    }
  }
}

Restart the host so it loads the server.
Ask it: List DeFi covers on Cover Raccoon and check the best-scored one.

Direct HTTP integration, three steps: discover a product via cover-analyses (free), optionally preview the response shape via cover-schema (free), then check (free) for the clause-by-clause coverage gap map plus red flags. No payment, ever. Each step is its own row below.

Endpoints

Free

No auth, no payment, ever. Rate limited to 20 requests/minute per IP against abuse; cheap and cacheable enough for high-frequency agent use within that limit.

GET/api/cover/v1/analyses

Catalog of every scored cover: Raccoon Score and band, audience (retail or team), coverage-gap counts, red flags, cheapest premium snapshot, analysis date, and a web link to the full written analysis on the website. Source of the provider/product slugs the check endpoint uses.

GET/api/cover/v1/analyses/{provider}/{product}/check

Decision check: does this cover actually pay for my risk? Clause-by-clause coverage gap map (covered/conditional/excluded, with notes) plus red-flag texts. Signed, even though free. No receipt needed, built for high-frequency agent use.

GET/api/cover/v1/schema

Placeholder-filled response shape of the two endpoints above, so you can see what you would get without an extra call.

check carries a signed attestation field: a keccak256 digest of the canonical JSON payload, signed EIP-191. Verify it offline against the signer address published in agent.json's attestation.signer to prove provenance downstream.

Agents · MCP

The coverraccoon-mcp package exposes both endpoints above as tools for Claude Desktop, Cursor, or any MCP host. Both are free, no key or wallet needed.

cover_listcover_check

{
  "mcpServers": {
    "coverraccoon": {
      "command": "npx",
      "args": ["-y", "coverraccoon-mcp"]
    }
  }
}

Resources

OpenAPI A2A agent card npm package GitHub source X Farcaster

Read-only API. Analyses are dated snapshots with sources, not insurance advice and not a recommendation. Nexus Mutual cover pays out on a discretionary claims-assessment basis; buyers must become Nexus Mutual members to file a claim. The full written analysis and the cover purchase flow are on the website only, at coverraccoon.com/cover/{provider}/{product}.