Repolode
Submit
sepehr071

sepehr071/iran-mcp

A collection of 70+ unofficial MCP servers that let AI agents search and compare Iranian websites such as Digikala, Torob, Divar and Snappfood, with prices in Toman.

View on GitHub
Stars
226
Forks
23
Open issues
1
Last commit
17 hours ago

What is it?

iran-mcp is a set of Model Context Protocol servers that give AI agents access to Iranian websites. It covers shopping (Digikala, Torob, Basalam, Okala), classifieds (Divar, Sheypoor), cars, food delivery, travel and stays, maps (Neshan, Balad), health appointments, books, courses, job boards, freelance platforms, stock market and economic data, laws, tax tools and crypto prices. Most sites have no public API, so each server maps a site's undocumented endpoints and exposes them as typed tools.

Each server is a small Python package installable with uvx, and the project also offers Claude Code plugins and bundles such as iran-travel or iran-all. A few servers are hosted by their sites (Pasavard, SwapWallet) or are official (ExirYab). Most tools are read-only and need no account; payping, bale and swapwallet act on the user's own account with a token or sign-in.

The project ships 896 tools across these servers, and prices are normalized to Toman where the source uses Rial. Several market servers return Rial as stated by their sources, and some only answer from Iranian connections.

Key features

  • 01Covers 70+ Iranian sites across shopping, travel, health, jobs, markets and government records.
  • 02Prices are shown in Toman, with Rial kept where the source publishes it.
  • 03Installable per server with uvx, or as Claude Code plugins and bundles.
  • 04Most servers are read-only and need no account or API key.
  • 05Works with Claude, Cursor, VS Code Copilot and any MCP-compatible client.

Use cases

  • Comparing product prices across Iranian shops from a chat with an AI agent.
  • Planning a trip by pulling flights, stays and tours from several booking sites at once.
  • Finding doctors with free appointment slots near you.
  • Looking up Tehran Stock Exchange quotes, fund NAVs or Central Bank rates for analysis.

Quick start

  1. 1

    Add the marketplace in Claude Code

    claude plugin marketplace add sepehr071/iran-mcp
  2. 2

    Install one server by name

    claude plugin install digikala@iran-mcp
  3. 3

    Or add a single server directly with uvx

    claude mcp add digikala -- uvx digikala-mcp

Things to know

  • The servers are unofficial and map undocumented site APIs, so they can break when sites change.
  • Some sites block requests or show bot-check pages; a browser fallback is optional.
  • Many servers quote Rial, and several only work from Iranian connections.
  • 896 tools can take a lot of agent context, so enable only the servers you need.

In collections

MCP servers for Claude CodeClaude Code tools, skills & pluginsOpen-source AI agent frameworks & appsMCP serversAI agent skill libraries

Topics

#mcp#ai-agents#model-context-protocol#web-scraping#price-comparison#iran#claude-code#python#agent-skills#claude

FAQ

What is iran-mcp?
A collection of 70+ unofficial MCP servers that let AI agents search and compare Iranian websites such as Digikala, Torob, Divar and Snappfood, with prices in Toman. iran-mcp is a set of Model Context Protocol servers that give AI agents access to Iranian websites. It covers shopping (Digikala, Torob, Basalam, Okala), classifieds (Divar, Sheypoor), cars, food delivery, travel and stays, maps (Neshan, Balad), health appointments, books, courses, job boards, freelance platforms, stock market and economic data, laws, tax tools and crypto prices. Most sites have no public API, so each server maps a site's undocumented endpoints and exposes them as typed tools.
Is iran-mcp free to use? What license does it have?
iran-mcp is open source under the MIT license. Check the license terms before using it in commercial products.
Is iran-mcp still maintained?
Actively maintained. The last commit to iran-mcp was on Nov 6, 2026.
What can I use iran-mcp for?
Comparing product prices across Iranian shops from a chat with an AI agent. Planning a trip by pulling flights, stays and tours from several booking sites at once. Finding doctors with free appointment slots near you. Looking up Tehran Stock Exchange quotes, fund NAVs or Central Bank rates for analysis.
How do I install iran-mcp?
Add the marketplace in Claude Code: claude plugin marketplace add sepehr071/iran-mcp Install one server by name: claude plugin install digikala@iran-mcp Or add a single server directly with uvx: claude mcp add digikala -- uvx digikala-mcp
Where can I get iran-mcp?
The source code and installation instructions are on GitHub: https://github.com/sepehr071/iran-mcp

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects