sepehr071 avatar

Iran Bus Tickets

sepehr071/iran-bus-mcp

Read-only Iranian bus tickets (Safar724): trips, Toman prices, free seats, cheapest ticket.

tools
5
transport
STDIO
env var
1
last updated
Nov 18, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

bus_citiesLook up cities (name, code, province) that tickets can be bought for; use it to spell a city exactly.

Look up cities (name, code, province) that tickets can be bought for; use it to spell a city exactly.

No parameter schema in public metadata yet.

bus_searchList bus trips between two cities on one day: time, company, bus type, price in Toman, free seats, terminals.

List bus trips between two cities on one day: time, company, bus type, price in Toman, free seats, terminals.

No parameter schema in public metadata yet.

bus_cheapestCheapest bus trips between two cities on one day, merged across providers and sorted by price in Toman.

Cheapest bus trips between two cities on one day, merged across providers and sorted by price in Toman.

No parameter schema in public metadata yet.

bus_terminalsList the departure and arrival terminals that have trips on a route and the companies running them.

List the departure and arrival terminals that have trips on a route and the companies running them.

No parameter schema in public metadata yet.

bus_tripSeat map summary and refund penalties of one trip: free seat numbers, seats taken by men or women.

Seat map summary and refund penalties of one trip: free seat numbers, seats taken by men or women.

No parameter schema in public metadata yet.

Sponsors

Configuration

IRAN_BUS_MCP_PROXY

Optional HTTP proxy URL for the bus-site requests; system proxy settings are ignored. Also accepts a comma-separated list: one is used until it gets blocked or fails to connect, then the next.

Readme

iran-bus-mcp: unofficial Iran intercity bus ticket (بلیط اتوبوس) MCP server that searches Safar724 trips, Toman prices and free seats for Claude, Cursor and Copilot

iran-bus-mcp: Iran bus tickets (بلیط اتوبوس) MCP server for AI agents, Safar724

iran-bus-mcp is an unofficial, read-only MCP server that lets an AI agent search intercity bus trips, prices in Toman and free seats on Safar724 (سفر ۷۲۴, safar724.com), the Iranian bus ticket marketplace.
Its 5 tools look up cities, list the trips between two cities on a day, find the cheapest ticket, list terminals and companies on a route, and show the free seats and refund rules of one trip.
No API key or account is needed; it works in Claude, Cursor, Copilot and any other MCP client.


View the full README on GitHub

Details

Repository
github.com/sepehr071/iran-bus-mcp
Website
github.com/sepehr071/iran-bus-mcp
Package
iran-bus-mcp
Transport
STDIO
Registry
MCP registry, active

More from sepehr071