iran-insurance-mcp: Iran insurance (بیمه) MCP server for AI agents, BimeBazar + Azki

iran-insurance-mcp is an unofficial, read-only MCP server that lets an AI agent compare Iranian insurance on two marketplaces, BimeBazar (بیمه‌بازار, bimebazar.com) and Azki (ازکی, azki.com), side by side.
Its 18 tools rank insurers by rating, compare live travel insurance prices from both sites in one call, and quote third-party car insurance (بیمه شخص ثالث), car body (بیمه بدنه), motorcycle, fire (آتش‌سوزی) and supplementary health (بیمه تکمیلی) on BimeBazar.
No API key or account is needed; it works in Claude, Cursor, Copilot and any other MCP client.

For AI agents · Quick start · What it can do · Tools · Limits · FAQ · فارسی

For AI agents

• What: unofficial MCP server (model context protocol) for bimebazar.com and azki.com, merged: insurers with ratings, vehicle and place lookups, travel insurance prices from both, guides and FAQ, plus each site's own tools.
• Install: uvx iran-insurance-mcp or claude mcp add iran-insurance -- uvx iran-insurance-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none. Optional IRAN_INSURANCE_MCP_PROXY (HTTP proxy URL, or a comma-separated list) applies to both sites; system proxy settings are ignored.
• Access: read-only. It cannot log in, buy, pay or file a claim, and never asks for a national ID, phone number or plate.
• Tools: 18, all prefixed ins_. Five take provider (all default, bimebazar, azki) and answer with one block per provider; if one site fails its block holds an error and the other still answers.
• Use when: the user asks which insurer is rated best, what third-party, body, motorcycle, fire or supplementary health insurance costs, what travel insurance costs on each site, where to file a claim, or how an insurance line works.
• Do not use when: the user needs a purchase, a life insurance price, or a plate/national-ID inquiry.
• Output: compact JSON. Prices are Toman unless a field says otherwise, years Jalali, text Persian.
• Rate limit: BimeBazar allows about 25-30 calls per minute per IP. A travel comparison uses about five calls; do not loop.
• Machine-readable: server.json and the iran-mcp catalog.

Last verified: 2026-11-01.

What it can do

• Compare insurers (شرکت‌های بیمه) with each site's ratings: BimeBazar market share, satisfaction and solvency; Azki service stats and customer rating
• Compare travel insurance (بیمه مسافرتی) prices from both sites for the same trip in one call, by country name and stay length
• Quote third-party car insurance (بیمه شخص ثالث), cheapest first, with or without a previous policy (BimeBazar)
• Quote car body (بیمه بدنه), motorcycle, home fire (بیمه آتش‌سوزی) and supplementary health (بیمه تکمیلی) for one person, several people or a family (BimeBazar)
• Estimate a car's market value and list optional body covers and no-claim discount steps (Azki)
• Find vehicles and places: brand and model ids from both catalogs, provinces and cities with each site's ids
• Read customer reviews of insurers, find damage-claim branches by insurer and place, look up insurance and car-card terms
• Read guides and FAQs of each insurance line, plus Azki's company pages, products and blog

Example prompts:

• "Compare Iranian car insurance prices from an AI agent: which insurer is cheapest for third-party insurance on a Peugeot 206?"
• "Compare travel insurance for Turkey for 7 days on BimeBazar and Azki."
• "Which Iranian insurance company has the best customer satisfaction and claim payment?"
• "Where can I file a car damage claim with this insurer in Tehran?"
• ارزان‌ترین بیمه شخص ثالث برای پژو ۲۰۶ کدام شرکت است؟
• قیمت بیمه مسافرتی ترکیه برای ۷ روز در بیمه‌بازار و ازکی را مقایسه کن.
• کدام شرکت بیمه بیشترین رضایت مشتری را دارد؟

Quick start

You need uv. No API key or account.

claude mcp add iran-insurance -- uvx iran-insurance-mcp

{
  "mcpServers": {
    "iran-insurance": { "command": "uvx", "args": ["iran-insurance-mcp"] }
  }
}

{
  "servers": {
    "iran-insurance": { "type": "stdio", "command": "uvx", "args": ["iran-insurance-mcp"] }
  }
}

Tools

Merged (both sites, provider argument):

BimeBazar only:

Azki only:

Travel is the one quote both sites price anonymously, so it is merged. The other quote tools stay BimeBazar only: Azki shows car, health, life and fire prices only after a phone number. Inputs also differ (BimeBazar asks brand/model values and previous-policy details; Azki's flow has no public price call), so there is nothing to merge.

Migrating from the single-site servers: bb_insurers/az_companies -> ins_insurers; bb_vehicles/az_vehicles -> ins_vehicles; bb_locations/az_zones -> ins_places; bb_quote_travel/az_travel_quote (+ both country lists, az_lookup travel lists) -> ins_quote_travel; bb_faq/az_landing -> ins_content; bb_quote_* -> ins_quote_*; bb_insurer_reviews, bb_claim_centers, bb_glossary -> ins_*; az_car_value, az_body_options, az_products, az_company, az_blog -> ins_azki_*. az_lookup is not exposed (the travel lists it served are used internally).

Limits

• Azki does not show car (third-party, body, motorcycle), health, life or fire premiums without a phone number, so only BimeBazar prices those. Life insurance offers are empty on BimeBazar too (it also asks for a phone number first).
• The Sanhab plate/national-ID inquiry is not exposed; ins_content('sanhab') explains it.
• BimeBazar rate-limits one IP to about 25-30 calls per minute (HTTP 429); the client backs off and retries, and a travel comparison uses about five calls.
• Azki travel prices come as the API sends them; their currency is not confirmed (they sit on the same scale as BimeBazar's Toman prices). medical_cover is a foreign-currency amount, not Toman.
• Quotes are estimates for comparison; the price to pay is shown only when buying on the site. Unofficial: not affiliated with either site. Site and blog text is third-party content.
• Both sites sit behind Iranian CDNs; from abroad set IRAN_INSURANCE_MCP_PROXY to a proxy that works, or run from Iran. The server ignores system proxy variables on purpose.

FAQ

npx @modelcontextprotocol/inspector uvx iran-insurance-mcp

Configuration

فارسی: سرور MCP بیمه برای دستیار هوش مصنوعی

claude mcp add iran-insurance -- uvx iran-insurance-mcp

Development

git clone https://github.com/sepehr071/iran-insurance-mcp && cd iran-insurance-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests on recorded fixtures
uv run python -m pytest -m live -q  # live calls to BimeBazar and Azki (few, mind the rate limit)

Issues and PRs are welcome. Releases: bump the version in pyproject.toml and server.json, then push a v* tag; GitHub Actions publishes to PyPI.

Related servers

• codal-mcp for Codal disclosures and financial statements of Iranian listed companies
• tsetmc-mcp for Tehran Stock Exchange prices, order book and indices
• iran-gold-mcp for live 18k gold prices on Iranian platforms
• iran-mcp: catalog of all Iranian-service MCP servers

Disclaimer

Unofficial and not affiliated with or endorsed by BimeBazar or Azki. It is read-only and uses the public API and pages of those sites, which can change without notice. Data is informational and quotes are estimates; nothing here is insurance or financial advice.

Author

Built and maintained by Sepehr Radmard (سپهر رادمرد). Connect on LinkedIn or follow @sepehr071 on GitHub for more MCP servers for Iranian websites, all listed in iran-mcp. If this saves you time, a star on the repo helps other people find it.

License

MIT