Insuraj MCP server — developer docs

Insuraj exposes household insurance terms to AI agents through the Model Context Protocol. Every coverage answer cites the clause and document version it comes from.

Connection

• Transport: MCP Streamable HTTP, stateless, JSON responses.
• Endpoint: https://mcp.insurajme.com/mcp — planned; not reachable yet.
• Auth: Authorization: Bearer <token>. Tokens are issued on request during the private preview: hello@insurajme.com.
• Access: read-only. No tool creates, changes or binds anything.

Tools

• list_products() → products in the catalog, each with its insurance class and the perils it documents.
• check_coverage(product_id, peril) → covered · excluded · conditional · optional_extra · not_in_catalog, with conditions and the cited clauses (id, article, title, document, version). Perils accept Macedonian or English names, e.g. "поплава" or "flood".
• get_clause(clause_id) → the verbatim clause text and the document it belongs to.
• explain_term(term) → an insurance term mapped Macedonian ↔ English, e.g. "франшиза" ↔ "deductible".
• how_to_buy(product_id) → human channels for getting a quote. Nothing is bound here.

Rules for agents

• Quote coverage only from tool results, together with the clause id and document version.
• Treat not_in_catalog as “not documented here” — never infer cover.
• Never present an answer as an offer, a price quote or advice; send the user to how_to_buy.

Example: Claude Code

Once you have a token:

claude mcp add --transport http insuraj https://mcp.insurajme.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

What Insuraj is not