MrBilit

mrbilit-mcp: MrBilit MCP server for AI agents

Let your AI agent plan trips in Iran with MrBilit (مستربلیط).

An unofficial, read-only MCP server for MrBilit, an Iranian travel site for flights, trains, buses, taxis and hotels:

find the cheapest option on a date or over a month, see seats, baggage and refund rules, and compare hotel rooms with exact prices, from Claude, Cursor or Copilot.

For AI agents · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development · Related servers · Disclaimer · License

For AI agents

• What: unofficial, read-only MCP server for MrBilit (مستربلیط), an Iranian travel site: flights, trains, intercity buses, private taxis and hotels. Queries work in Persian and English; prices are in Toman.
• Install: claude mcp add mrbilit -- uvx mrbilit-mcp (stdio transport; needs Python 3.10+ and uv).
• Auth: none, no API key or account. Optional MRBILIT_MCP_PROXY (HTTP proxy), only if your network cannot reach MrBilit's API servers.
• Access: read-only (all 22 tools carry readOnlyHint: true). No login, seat hold, booking or payment, so no confirmation is needed before calling tools.
• Tools: 22, all prefixed mb_*. Call mb_find_place first for the codes every search takes, then a price calendar (mb_flight_price_calendar, mb_train_price_calendar, mb_bus_price_calendar) → mb_search_flights / mb_search_trains / mb_search_buses → mb_flight_fare_details, mb_train_price or mb_bus_seats. Hotels: mb_search_hotels → mb_hotel_rooms.
• Use when: comparing the cheapest plane, train, bus or taxi between Iranian cities, or hotel prices, with seats and refund rules.
• Do not use when: you need to book, hold a seat or pay (the user does that on mrbilit.com).
• Output: compact JSON. Prices in Toman in *_toman fields, dates Gregorian YYYY-MM-DD, ratings 0-5. Ids such as flight_id, class_id and bus_id come from a fresh search and expire.
• Machine-readable: server.json; catalog of all Iranian MCP servers: iran-mcp (TOOLS.md, servers.json, llms.txt).

Why

MrBilit (mrbilit.com, مستربلیط) sells flights, trains, intercity buses, private taxis and hotels in one place, but each one has its own search, calendar and rules. Comparing "plane or train or bus, which day, which seat" means a dozen page loads. An agent with mrbilit-mcp does it in one go:

You: Cheapest way to get from Tehran to Mashhad on 20 October?

Agent: *calls* mb_search_flights(origin="THR", destination="MHD", date="2026-10-20"),

mb_train_price_calendar(origin=1, destination=191), mb_search_buses(origin=11320000, destination=31310000, date="2026-10-20", sort="cheapest")

| Mode | Cheapest option | Departs | Price (Toman) |

|---|---|---|---|

| Bus | Peyk Saba VIP, Tehran South terminal, 17 seats left | 21:00, arrives 09:00 | 1,313,000 |

| Train | cheapest seat of the day (price calendar) | list with mb_search_trains | 760,000 |

| Flight | Mehr Air MEH 4200, Mehrabad, 2 seats left | 08:30, arrives 09:30 | 11,856,000 |

The train is cheapest; want me to list that day's trains and free seats with mb_search_trains?

Real tool output from 2026-10-04; prices and seats change all the time. Prices are in Toman.

What it can do

• Flights: domestic and international, one-way or round trip, party prices, cabin/airline/direct/time filters
• Cheapest day for flights, trains and buses over weeks, and the cheapest nights of a hotel
• Trains: every class with free seats, exact price for children, infants or a whole compartment, every stop
• Buses and taxis: terminals, companies, VIP, seat maps with women/men seats, private door-to-door cars
• Alternatives when trains are full: one-change trips, nearby stations, bus routes and airports
• Hotels: available stays with prices, every hotel of a city, guest ratings and reviews, rooms and exact prices
• Context: current site notices, official refund and baggage rules, help-center guides, route guides
• Read-only by design: no login, no seat hold, no booking, no payment

Example prompts:

• "Cheapest day to fly Tehran to Kish in the next month, and the baggage on that flight?"
• "Train from Tehran to Mashhad next Friday for 2 adults and a child: which classes have seats and what's the total?"
• "4-star hotels in Shiraz for 3 nights from the 20th under 3 million Toman a night, with their reviews."
• "The Tehran to Tabriz train is full on Thursday. What else gets me there?"
• ارزان‌ترین اتوبوس VIP تهران به اصفهان فردا شب و صندلی‌های خالی آن؟
• ارزان‌ترین روز برای پرواز تهران به کیش در ماه آینده کدام است؟
• هتل‌های ۴ ستاره مشهد برای سه شب با قیمت دقیق اتاق‌ها را مقایسه کن.

Quick start

You need uv. No API key or account.

Claude Code

claude mcp add mrbilit -- uvx mrbilit-mcp

Outside Iran, if MrBilit's API does not answer, add a proxy:

claude mcp add mrbilit -e MRBILIT_MCP_PROXY=http://127.0.0.1:8080 -- uvx mrbilit-mcp

Claude Desktop

Settings → Developer → Edit Config, then add:

{

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

Need a proxy? Add "env": { "MRBILIT_MCP_PROXY": "http://127.0.0.1:8080" } next to args.

Cursor

Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.

VS Code (Copilot agent mode)

Click Install in VS Code above, or add to .vscode/mcp.json:

{

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

</details>

Codex CLI

codex mcp add mrbilit -- uvx mrbilit-mcp

Or in ~/.codex/config.toml:

[mcp_servers.mrbilit]

command = "uvx" args = ["mrbilit-mcp"]

</details>

Gemini CLI

Add to ~/.gemini/settings.json:

{

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

</details>

Windsurf

Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.

Anything else

It's a standard stdio MCP server: run uvx mrbilit-mcp, or pip install mrbilit-mcp and run mrbilit-mcp.

Then ask the prompts above, in Persian or English.

Tools

Every search takes the codes from mb_find_place: IATA codes for flights (THR, MHD, ISTALL), station ids for trains (Tehran 1, Mashhad 191), 8-digit city ids for buses and taxis (Tehran 11320000), slugs for hotels (mashhad, mashhad/enghelab).

Places and companies (2)

Flights (3)

Trains (5)

Buses and taxis (4)

Hotels (5)

Notices and help (3)

| mb_help | Search the official rules, FAQ and help-center guides (refunds, baggage, auto-rese