Skip to main content
iran-roads-mcp: unofficial Iran road status (راهداری) MCP server that reads road closures, traffic restrictions, road works and weather warnings from 141.ir for Claude, Cursor and Copilot

iran-roads-mcp: 141.ir (راهداری) road status MCP server for AI agents, Iran road closures and traffic

iran-roads-mcp is an unofficial, read-only MCP server that lets an AI agent read Iran's road status from 141.ir (۱۴۱, the road information service of the Road Maintenance and Transportation Organization, RMTO, راهداری و حمل‌ونقل جاده‌ای).
Its 8 tools read the official road bulletin, closed roads, police traffic restrictions, road works, road weather warnings, the 22 main intercity axes and province traffic map images.
No API key or account is needed; it works in Claude, Cursor, Copilot and any other MCP client.

PyPI Python CI License: PolyForm Noncommercial

For AI agents · Quick start · Tools · Limits · فارسی


For AI agents

  • What: unofficial MCP server (model context protocol) for 141.ir and its API api.141.ir: the road bulletin, closures, traffic restrictions, road works, weather warnings, main axes and province traffic maps.
  • Install: uvx iran-roads-mcp or claude mcp add iran-roads -- uvx iran-roads-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional IRAN_ROADS_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
  • Access: read-only, no confirmation needed. It answers from any network, an Iranian IP is not required.
  • Tools: 8, all prefixed rd_. List tools take province (id or Persian name, from rd_provinces), limit and page.
  • Use when: the user asks whether a road in Iran is closed, what traffic limits or road works are active, or what the road weather warning says.
  • Do not use when: the user needs live traffic counters or road cameras, which are not offered.
  • Output: compact JSON with Persian official announcement texts, ASCII digits and coordinates.

Quick start

You need uv. No API key or account.

Claude Code:

claude mcp add iran-roads -- uvx iran-roads-mcp

Claude Desktop, Cursor, VS Code and other clients:

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

Example prompts:

  • "Which roads are closed in Iran right now?"
  • "Are there road works on the Tehran-Qom highway?"
  • "What is the latest road weather bulletin for the northern axes?"
  • آیا جاده‌ی فشند - طالقان بسته است؟
  • محدودیت‌های ترافیکی فعلی در استان کردستان چیست؟

Real answer (17 Nov 2026): rd_closures returned 5 closures in total, among them "انسداد در قشند ( فشند - طالقان )" in Alborz (since 2026-11-07). rd_workshops returned 81 road works and rd_restrictions 1 police restriction.

Tools

Tool What it does
rd_provinces List the 31 provinces with the ids the other tools accept.
rd_bulletin Latest official road weather and traffic status bulletin of the Road Maintenance Organization.
rd_closures List current road closures (blockades) with cause, direction, alternative route text and coordinates.
rd_restrictions List traffic restrictions announced by the traffic police (vehicle types or hours, road still open).
rd_workshops List road works with work type, whether traffic can pass, period and alternative route.
rd_weather Current road weather warnings: hazard, affected provinces by day and validity dates.
rd_main_routes List the 22 main intercity axes the 141 app tracks, with endpoints.
rd_traffic_map Get the URL of a province's traffic status map image.

Limits

  • Entries stay listed until the operator removes them: some closures date from years ago. Check the since and until fields.
  • Not offered: traffic counters (تردد شمار, they need a 141 login) and road cameras (the public camera endpoint returns nothing).
  • The province filter of the bulletin was not verified for every province (it returned nothing for two provinces tested).
  • The tools read the same API the 141.ir page calls. Counts were matched against the page's banner and slideshow, not field by field against the page.
  • Texts are Persian official announcements. The traffic map tool returns an image URL, not the image.

How it works

141.ir has no documented public API. The server calls the JSON routes of api.141.ir that the site itself uses, always sending a JSON Accept header (Laravel answers errors with a redirect otherwise). The routes were mapped in a real browser and the 141.ir page counts (81 road works, 1 police restriction, 5 closures, 1 weather warning) were checked in Chrome against the tool totals. Requests present Chrome's TLS fingerprint, run two at a time with a short cache.

فارسی

iran-roads-mcp یک سرور MCP غیررسمی و فقط‌خواندنی است که به دستیار هوش مصنوعی اجازه می‌دهد وضعیت جاده‌های ایران را از سامانه‌ی ۱۴۱ (راهداری و حمل‌ونقل جاده‌ای) بخواند: بولتن رسمی وضعیت جاده‌ها، جاده‌های مسدود، محدودیت‌های ترافیکی پلیس، کارگاه‌های جاده‌ای، هشدارهای هواشناسی جاده‌ای، محورهای اصلی و نقشه‌ی ترافیک استان‌ها. کلید API یا حساب کاربری لازم نیست. نصب در Claude Code:

claude mcp add iran-roads -- uvx iran-roads-mcp

Development

uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline tests on recorded fixtures
uv run python -m pytest -m live -q  # real api.141.ir

Releases: bump the version in pyproject.toml and server.json, run uv lock, then push a v* tag; GitHub Actions publishes to PyPI and the MCP Registry.

Disclaimer

Unofficial and not affiliated with or endorsed by RMTO or 141.ir. It is read-only and uses the public API of 141.ir, which can change without notice. For safety decisions on the road, follow official announcements.

Author

Built and maintained by Sepehr Radmard (سپهر رادمرد). LinkedIn · GitHub · more servers in iran-mcp.

مجوز استفاده (License)

استفادهٔ شخصی و غیرتجاری رایگان است؛ برای استفادهٔ تجاری با سپهر رادمرد تماس بگیرید. Free for personal and non-commercial use; commercial use needs a license.

استفادهٔ شخصی و غیرتجاری رایگان است. استفاده در شرکت، محصول پولی یا پروژهٔ مشتری به مجوز تجاری نیاز دارد؛ از راه لینکدین یا گیت‌هاب با سپهر رادمرد تماس بگیرید. متن کامل: PolyForm Noncommercial 1.0.0. نسخه‌های پیش از 0.1.1 با مجوز MIT منتشر شده‌اند و همان مجوز را دارند.

Free for personal and non-commercial use under the PolyForm Noncommercial License 1.0.0. Using it in a company, a paid product or a client project needs a commercial license: contact Sepehr Radmard on LinkedIn or GitHub. Versions before 0.1.1 were released under MIT and stay under it.

Metadata

Release files for iran-roads-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iran-roads-mcp 0.1.1
File Size Uploaded Provenance Actions
iran_roads_mcp-0.1.1.tar.gz 407.7 kB With provenance Details for iran_roads_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for iran-roads-mcp 0.1.1
File Interpreter ABI Platform Actions
iran_roads_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for iran_roads_mcp-0.1.1-py3-none-any.whl

Total release size: 424.3 kB

Release files / iran_roads_mcp-0.1.1.tar.gz

Download URL iran_roads_mcp-0.1.1.tar.gz
Size 407.7 kB
Tags Source
SHA-256 checksum
How to use checksums
057ff6c65f03e5df5d9f21d9b36fd64bd9d35cc4efea7cb46ae12c8dfeeceee4
BLAKE2b-256 checksum
How to use checksums
e45b9146e09992ea9dfae5da7d0012f11416da86e48cb5adccbf05968d93b9b9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / iran_roads_mcp-0.1.1-py3-none-any.whl

Download URL iran_roads_mcp-0.1.1-py3-none-any.whl
Size 16.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b2372a6cf5e9d5026df9f30b8a2202b7ae4e41f289a025359c0ee8327cda3c96
BLAKE2b-256 checksum
How to use checksums
1a13cf9969b1eb70c0fe4eef382165c7c0ba5d26a7f5258163e57c1ec4e9ef06
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for iran-roads-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for iran_roads_mcp-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page