iran-news-mcp: Iranian news RSS MCP server for AI agents
Let your AI agent read Iranian news (اخبار ایران) from Mehr, Khabaronline, Hamshahri, Tabnak, Zoomit and Digiato.
An unofficial, read-only MCP server over the sites' public RSS feeds and article pages: latest headlines per source and category, a merged overview, keyword search across all six, and the full text of any story.
For AI agents · Quick start · Tools · Sources · فارسی
For AI agents
- What: unofficial MCP server for the RSS feeds and article pages of Mehr (mehrnews.com), Khabaronline (khabaronline.ir), Hamshahri (hamshahrionline.ir), Tabnak (tabnak.ir), Zoomit (zoomit.ir) and Digiato (digiato.com). Persian text.
- Install:
uvx iran-news-mcporclaude mcp add iran-news -- uvx iran-news-mcp. Transport: stdio. Needs uv (Python 3.10+). - Auth: none. Optional
IRAN_NEWS_MCP_PROXY(HTTP proxy URL, or a comma-separated list); system proxy settings are ignored. - Access: read-only. No login or posting, so no confirmation is needed before calling any tool.
- Tools: 5:
nw_list_sources,nw_latest,nw_search,nw_latest_all,nw_article. Start withnw_list_sourcesfor valid source ids and category slugs. - Use when: the user wants current Iranian headlines, a news overview, recent coverage of a keyword, or the full text of a story.
- Do not use when: an archive is needed (only what is in the current feeds, 10 to 300 stories per feed, is searchable).
- Output: compact JSON. Times are UTC ISO strings (Tehran is UTC+3:30); summaries are plain text cut to 200 characters (80 in
nw_latest_all). Null and empty fields are omitted. Replies stay under ~15 KB:limitis capped at 15 andper_sourceat 3. A failing source is listed undererrorswhile the others still answer.nw_latestsetsstale: truewhen a feed's newest story is over 3 days old. Feeds are cached for 3 minutes. - Machine-readable:
server.jsonand the awesome-iran-mcp catalog.
Quick start
claude mcp add iran-news -- uvx iran-news-mcp
Other clients: command uvx, args ["iran-news-mcp"].
Tools
| Tool | What it does |
|---|---|
nw_list_sources |
The six sources and their category slugs. |
nw_latest |
Newest headlines of one source, optionally one category (source, category, limit 1-15). |
nw_search |
Keyword search over the current feeds of several sources (query, sources, category, limit 1-15). |
nw_latest_all |
Newest headlines from every source merged by time (sources, category, per_source 1-3). |
nw_article |
Full body text of one story from its url, in parts of 6000 characters (url, part). |
Sources
| id | Site | Categories | Feeds |
|---|---|---|---|
mehr |
Mehr | 14 | one per category (30 items) |
khabaronline |
Khabaronline | 12 | one per category (30 items) |
hamshahri |
Hamshahri | 16 | one per category (30 items) |
tabnak |
Tabnak | 11 | one per category (up to 100 items) |
zoomit |
Zoomit | 18 | one feed (300 items), categories filtered here |
digiato |
Digiato | 14 | one per topic (10 items) |
Common slugs shared by most sources: politics, economy, society, culture, world, sports, science, provinces, photo. The sites offer more sub-category feeds than listed here; see the API map.
FAQ
Does it work outside Iran? Yes: the RSS endpoints answered from a Turkish exit and from a direct connection in testing. Article pages of Mehr, Khabaronline, Hamshahri, Tabnak, Zoomit and Digiato also answered from both.
Why no ISNA or IRNA? Their article pages (also /amp/ and /print/) answer every non-browser client with an ArvanCloud JavaScript check, from an Iranian connection too, so only headlines would work. They were left out.
فارسی
سرور MCP غیررسمی و فقطخواندنی برای خوراک RSS و صفحههای خبر شش سایت خبری: مهر، خبرآنلاین، همشهری، تابناک، زومیت و دیجیاتو. آخرین عناوین هر منبع و دسته، مرور ترکیبی، جستوجوی کلیدواژه در همه منابع و متن کامل خبر.
claude mcp add iran-news -- uvx iran-news-mcp
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for iran-news-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| iran_news_mcp-0.1.0.tar.gz | 108.0 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| iran_news_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 127.7 kB
Release files / iran_news_mcp-0.1.0.tar.gz
| Download URL | iran_news_mcp-0.1.0.tar.gz |
|---|---|
| Size | 108.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
33d47f1ee7a0e24ba8dc700f2e9cabb98a9dd90018596e7e4f9ae79ba04fc877
|
|
BLAKE2b-256 checksum How to use checksums |
ca9d4e851dba3ed59e379874eb1cd496d0a42adf4ab64c24bb78ba53a1eb6f8a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 20, 2026.
Transparency logRelease files / iran_news_mcp-0.1.0-py3-none-any.whl
| Download URL | iran_news_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 19.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
de7b61a44d67d35594faf8e03ed1a05863041124b531116e496d2239bc113395
|
|
BLAKE2b-256 checksum How to use checksums |
89e7c64e630de1ad2ce38dafd87828f4602502ff8e07d111f8fea2a5515ce064
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 20, 2026.
Transparency logSecurity for iran-news-mcp 0.1.0
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
All 2 files in this release have been uploaded with provenance metadata.
Attestation for iran_news_mcp-0.1.0.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 Oct 20, 2026.
Transparency logA 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.
