Repolode
Submit
sepehr071

sepehr071/mobile-ir-mcp

Unofficial read-only MCP server giving AI agents access to Mobile.ir, Iran's phone database, for specs, shop prices, used phones and SIM numbers.

View on GitHubWebsite
Stars
3
Forks
0
Open issues
1
Last commit
6 hours ago

What is it?

mobile-ir-mcp is an unofficial Model Context Protocol server that exposes Mobile.ir, a long-running Iranian phone database, to AI agents such as Claude, Cursor and Copilot. It provides 17 read-only tools covering phone, tablet and smartwatch search, a filter similar to the site's mobile finder, full specifications, per-shop prices in Toman, price history, used and new phone ads, and numbered SIM cards for sale.

The server runs locally over stdio and needs no API key or account. Mobile.ir has no JSON API, so it parses the public HTML and AJAX lists, limits itself to three concurrent requests and only contacts www.mobile.ir. Seller names and phone numbers are never returned, and all tools are marked read-only.

Installation uses uvx or pip, with optional HTTP proxy support through the MOBILE_IR_MCP_PROXY variable. Prices come from shops and users and are not verified by the site, so the tool output includes shop notes for comparison.

Key features

  • 01Searches phones, tablets and smartwatches by name in English or Persian.
  • 02Filters phones by brand, price range, OS, camera, weight and availability.
  • 03Compares shop prices for one model, with notes on variant, warranty and update time.
  • 04Shows price history per shop and the daily lowest price.
  • 05Searches used and new phone ads and numbered SIM cards by operator, digits and price.
  • 06Runs locally with no API key and never returns seller contact details.

Use cases

  • Asking an AI assistant which shop sells a given phone model cheapest in Iran.
  • Checking whether a phone's price has been rising or falling over the past month.
  • Finding phones within a budget that match camera or OS requirements.
  • Browsing used phone listings in a specific city or price range.

Quick start

  1. 1

    Install uv (Python package runner)

  2. 2

    Add the server to Claude Code

    claude mcp add mobile-ir -- uvx mobile-ir-mcp

Things to know

  • Unofficial project; Mobile.ir has no public API, so the server parses site HTML and may break if the site changes.
  • Prices are posted by shops and users and are not verified by the site.
  • The finder returns at most 100 phones with no paging.

In collections

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

Topics

#mcp#ai-agent#iran#phone-prices#price-tracking#web-scraping#python#claude#hamrah-aval#irancell

FAQ

What is mobile-ir-mcp?
Unofficial read-only MCP server giving AI agents access to Mobile.ir, Iran's phone database, for specs, shop prices, used phones and SIM numbers. mobile-ir-mcp is an unofficial Model Context Protocol server that exposes Mobile.ir, a long-running Iranian phone database, to AI agents such as Claude, Cursor and Copilot. It provides 17 read-only tools covering phone, tablet and smartwatch search, a filter similar to the site's mobile finder, full specifications, per-shop prices in Toman, price history, used and new phone ads, and numbered SIM cards for sale.
Is mobile-ir-mcp free to use? What license does it have?
mobile-ir-mcp is open source under the MIT license. Check the license terms before using it in commercial products.
Is mobile-ir-mcp still maintained?
Actively maintained. The last commit to mobile-ir-mcp was on Nov 7, 2026.
What can I use mobile-ir-mcp for?
Asking an AI assistant which shop sells a given phone model cheapest in Iran. Checking whether a phone's price has been rising or falling over the past month. Finding phones within a budget that match camera or OS requirements. Browsing used phone listings in a specific city or price range.
How do I install mobile-ir-mcp?
Install uv (Python package runner) Add the server to Claude Code: claude mcp add mobile-ir -- uvx mobile-ir-mcp
Where can I get mobile-ir-mcp?
The source code and installation instructions are on GitHub: https://github.com/sepehr071/mobile-ir-mcp

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

Related projects