Iran News RSS

iran-news-mcp: Iranian news MCP server for AI agents

Let your AI agent read Iranian news (اخبار ایران) from 10 Persian news sites.
An unofficial, read-only MCP server over the public RSS feeds and article pages of Mehr, Khabaronline, Hamshahri, Tabnak, Entekhab, Asriran, Zoomit, Digiato, Varzesh3 and Khabarvarzeshi:
latest headlines, a merged overview, keyword search and the full text of any story, from Claude, Cursor or Copilot.

[PyPI] [Python] [CI] [MCP Registry] [License: MIT] [mcpfarsi]

[Install in VS Code]

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

For AI agents

• What: unofficial MCP server (model context protocol) for the RSS feeds and article pages of Mehr (mehrnews.com), Khabaronline (khabaronline.ir), Hamshahri (hamshahrionline.ir), Tabnak (tabnak.ir), Entekhab (entekhab.ir), Asriran (asriran.com), Zoomit (zoomit.ir), Digiato (digiato.com), Varzesh3 (varzesh3.com) and Khabarvarzeshi (khabarvarzeshi.com). Text is Persian. Each source has a group: news, tech or sports.
• Install: uvx iran-news-mcp or claude mcp add iran-news -- uvx iran-news-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional IRAN_NEWS_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
• Access: read-only. It cannot log in or post, so no confirmation is needed before calling any tool.
• Tools: 6, all prefixed nw_: nw_list_sources, nw_latest, nw_search, nw_latest_all, nw_tech_news, nw_article. Start with nw_list_sources for valid source ids and category slugs; for any technology question start with nw_tech_news.
• 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 Persian text. Null and empty fields are omitted. Each item has a url to pass to nw_article.
• Machine-readable: server.json and the iran-mcp catalog.

Why

Iranian news is spread over many sites, in Persian, each with its own category layout and feed addresses. Asking "what happened in the economy today" or "what is being said about X" means opening several pages. With iran-news-mcp the agent lists the sources, pulls the newest headlines in one call (or searches them all for a keyword) and opens the full text of the story that matters.

What it can do

• Latest headlines of one source, optionally one category (politics, economy, society, culture, world, sports, science, provinces, photo, ...)
• Merged overview of every source (or a chosen group) sorted by time
• Keyword search over the stories currently in the feeds, with Arabic/Persian ي/ك and ZWNJ normalised
• Technology news from Digiato (read several feed pages deep) and optionally Zoomit
• Full article text of a story from its link, in parts of 6000 characters
• Sports news from Varzesh3 and Khabarvarzeshi
• Read-only by design: no login, no posting

Example prompts:

• "What are the top economy headlines on Entekhab and Khabaronline right now?"
• "Give me a one-line overview of the latest news from every source."
• "Search the news for 'earthquake' and summarize what the first two results say."
• "Latest smartphone news from Digiato and Zoomit."
• آخرین خبرهای اقتصادی همشهری و خبرآنلاین را بیاور.
• درباره «بورس» در خبرگزاری‌ها جست‌وجو کن و متن کامل مهم‌ترین خبر را خلاصه کن.
• تازه‌ترین اخبار فناوری از دیجیاتو و زومیت چیست؟

Quick start

You need uv. No API key or account.

claude mcp add iran-news -- uvx iran-news-mcp

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

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

codex mcp add iran-news -- uvx iran-news-mcp

[mcp_servers.iran-news]command = "uvx"args = ["iran-news-mcp"]

Tools

All tools are annotated readOnlyHint: true.

Sources

Common slugs shared by most sources: politics, economy, society, culture, world, sports, science, provinces, photo. Always call nw_list_sources for the exact slugs per source.

How it works

  AI agent  (Claude, Cursor, Copilot, ...)      │      │  MCP over stdio      ▼  iran-news-mcp  (runs on your machine)      │      │  HTTPS      └──────▶  public RSS feeds and article pages of the 10 news sites

iran-news-mcp runs locally, reads each site's public RSS feed (RSS 2.0 or Atom) and, for nw_article, the story's HTML page. There is no hosted server in between, no API key, and nothing about you is sent anywhere else.

Good to know

• Times are UTC ISO strings; Tehran is UTC+3:30.
• Feeds only, no archive. Search covers the stories currently in the feeds (10 to 300 per feed), newest first. It is a keyword match, not a full-text index of the sites.
• Reply size is capped at about 15 KB: limit is at most 15 and per_source at most 2. nw_tech_news is the exception (limit up to 30, summaries up to 300 characters, replies up to roughly 25 KB).
• Summaries are plain text cut to 200 characters (80 in nw_latest_all). Photo feeds (for example Mehr photo) have mostly empty descriptions.
• Stale feeds: nw_latest sets stale: true when a feed's newest story is more than 3 days old.
• Feeds are cached for 3 minutes, so repeated calls do not hit the sites again. Timeouts, network errors, 5xx and 429 are retried up to twice.
• Partial answers: a source that fails is listed under errors while the others still answer.
• Zoomit has a single feed, so its categories are filtered on this side. Digiato feeds hold 10 items, so nw_tech_news reads extra pages.
• No ISNA or IRNA. Their article pages sit behind a JavaScript challenge that plain clients cannot pass, so only headlines would work. They were left out.
• What it does NOT do: no login, no posting, no comments, no images in results, no archive search.
• Proxy: set IRAN_NEWS_MCP_PROXY if your network cannot reach the sites. Normal system proxy variables are ignored on purpose.

FAQ

Configuration

فارسی: سرور MCP اخبار ایران

claude mcp add iran-news -- uvx iran-news-mcp

Development

git clone https://github.com/sepehr071/iran-news-mcp && cd iran-news-mcpuv syncuv run python -m pytest            # offline, against recorded feedsuv run python -m pytest -m live    # real feedsuv run ruff check .

Tools live in src/iran_news_mcp/news.py (feeds, search, tech news) and article.py (story text); each is a typed async function with a docstring that tells the agent when to use it. Feed addresses are in the SOURCES table in news.py. Issues and PRs are welcome, especially new sources and fixes when a feed changes.

Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions tests, publishes to PyPI and the MCP Registry, and creates the GitHub Release.

Related servers

• Tgju MCP server for gold, currency and market prices
• Tsetmc MCP server for the Tehran Stock Exchange
• Iran Quake MCP server for earthquakes in Iran
• Iran Crypto MCP server for cryptocurrency prices in Iran
• iran-mcp: catalog of all Iranian-service MCP servers
• Listed on mcpfarsi.ir, the Persian MCP marketplace

Disclaimer

Unofficial and not affiliated with or endorsed by Mehr, Khabaronline, Hamshahri, Tabnak, Entekhab, Asriran, Zoomit, Digiato, Varzesh3 or Khabarvarzeshi. It reads their public RSS feeds and article pages, which can change without notice. Headlines and article text belong to their publishers; please keep request rates reasonable.

Author

[Sepehr Radmard: open-source MCP servers for the Iranian web. LinkedIn: linkedin.com/in/sepehr-radmard]

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