Statistical Centre of Iran

Name: Statistical Centre of Iran
Author: sepehr071

by sepehr071version 0.2.0i★ –iRuns on your computer

Registry nameio.github.sepehr071/amar-mcp

Install

Overview

Description from the maker (original English)

Read-only Statistical Centre of Iran (amar.org.ir): CPI inflation, unemployment, census, any table.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiEarly↓ 355/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Law & government data

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: AMAR_MCP_PROXY

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "amar": {
      "command": "uvx",
      "args": [
        "amar-mcp"
      ],
      "env": {
        "AMAR_MCP_PROXY": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add amar --env AMAR_MCP_PROXY=your-value -- uvx amar-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "amar": {
      "command": "uvx",
      "args": [
        "amar-mcp"
      ],
      "env": {
        "AMAR_MCP_PROXY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "amar": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "amar-mcp"
      ],
      "env": {
        "AMAR_MCP_PROXY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

AMAR_MCP_PROXY env
Optional HTTP proxy URL for the amar.org.ir requests; system proxy settings are ignored. Also accepts a comma-separated list: one is used until it gets blocked or fails to connect, then the next.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account sepehr071, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Law & government datai

More stars than 0% of the other 1758 servers in this category
Published to the registry more recently than 96% of the other 1758 servers in this category
Basic checks equal to or better than 100% of the other 1758 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Statistical Centre of Iran safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.2.0) reached the registry 2 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Gerro: госзакупки для ИИ / Russian public procurement, Contract Compass, sanctions.io MCP by usefulapi

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Gerro: госзакупки для ИИ / Russian public procurement

Госзакупки РФ в ИИ-чате: поиск, обеспечения, документы. Russian public procurement for AI chats.

by gerro.ruEarlyUpdated today

Runs in the cloud✓ gerro.ru

Install

Contract Compass

Korean public procurement law: rule-engine rulings, statutes search, live court precedents

by sallim-appVery newUpdated today

Runs in the cloud✓ sallim.app

Install

sanctions.io MCP by usefulapi

Screen names against sanctions, PEP and watchlists; list screening sources in sanctions.io.

by m190EarlyUpdated today

Runs in the cloud✓ usefulapi.io

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

amar-mcp: Statistical Centre of Iran (مرکز آمار ایران) inflation, unemployment and census MCP server

amar-mcp is an unofficial, read-only MCP server that gives AI agents the official numbers of the Statistical Centre of Iran (amar.org.ir).

Its 12 tools return the consumer price index and inflation (monthly, year-on-year, 12-month average, by CPI group, household region and province), unemployment and participation rates, GDP growth, producer prices, the monthly macro-indicators workbook (trade, housing price and rent, money, budget, household income and spending, CPI by decile), census population by province and county, news, the publishing calendar, and any Excel table of any release.

No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

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

For AI agents

What: unofficial MCP server (model context protocol) for amar.org.ir, Iran's national statistics portal: official CPI and inflation, labour force survey rates, census 1395 population, the release catalog and calendar, and a reader for the portal's Excel tables.
Install: uvx amar-mcp or claude mcp add amar -- uvx amar-mcp. Transport: stdio. Needs uv (Python 3.10+).
Auth: none. Optional AMAR_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
Access: read-only. It cannot log in or change anything, so no confirmation is needed before calling any tool.
Network: amar.org.ir answers only from inside Iran (it drops foreign IPs), so run the server on an Iranian connection or set AMAR_MCP_PROXY to an Iranian proxy.
Tools: 12, all prefixed am_. Typical sequences: am_inflation -> am_inflation_groups; am_gdp, am_ppi; am_indicators (topic -> table); am_search -> am_release -> am_table; am_calendar for "when is the next release".
Use when: the user asks what Iran's official inflation, CPI, unemployment or population is, what drives inflation (food, housing...), how a province compares, when the Statistical Centre publishes something, or wants any table from amar.org.ir.
Do not use when: the user wants central-bank data, exchange or gold prices (other servers cover those), or live market data. The monthly CPI Excel series trails the PDF report by about a week; am_inflation flags this in newer_report and reads the newer month's national figures from the PDF.
Output: compact JSON. Periods are Jalali (1405-06 = Shahrivar 1405). Percentages are percent. Names and titles are Persian as the Centre has them.
Machine-readable: server.json.

Example

You: What is Iran's official inflation, and what drives it?

Agent: *calls* am_inflation() and am_inflation_groups()

For Shahrivar 1405 the Statistical Centre reports 4.24% monthly, 89.8% year-on-year and 73.6% for the 12-month average. Food and tobacco rose 122% year-on-year, transport 115%, housing 38%.

Numbers from a live call on 2026-11-01.

Other prompts: "unemployment rate by quarter", "population of Yazd province and its counties", "inflation in Fars province", "when is the next CPI release", تورم نقطه به نقطه مسکن شهری چقدر است؟ , نرخ بیکاری آخرین فصل؟

Quick start

You need uv. No API key or account.

Claude Code: claude mcp add amar -- uvx amar-mcp

Claude Desktop, Cursor, Windsurf, Gemini CLI: add

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

VS Code: .vscode/mcp.json with {"servers": {"amar": {"type": "stdio", "command": "uvx", "args": ["amar-mcp"]}}}.

Codex CLI: codex mcp add amar -- uvx amar-mcp. Anything else: uvx amar-mcp, or pip install amar-mcp and run amar-mcp.

Tools

Tool	What it does
`am_inflation`	Official CPI index and inflation per month (monthly, point-to-point, 12-month average) by household region, CPI group or province
`am_inflation_groups`	Compare inflation across CPI groups (food, housing, transport...) for one month
`am_labour_force`	Unemployment, youth unemployment and participation rates by quarter, total, urban and rural
`am_population`	Population and households by province, or by county in one province, from the 1395 census
`am_search`	Search the portal's releases by Persian title words, year, frequency, type and topic (a year, frequency or kind alone searches the portal's own releases)
`am_release`	One release: topic, period and its Excel, PDF and Word files
`am_table`	Read any Excel table of a release as compact rows (sheet list, filter, paging)
`am_calendar`	The publishing calendar: which statistic comes out on which day of a month
`am_gdp`	GDP growth by quarter or year with agriculture, industry, oil and gas, services; levels in billion rials
`am_ppi`	Producer price index by quarter and sector (index, quarterly, year-on-year, 4-quarter average)
`am_indicators`	The monthly macro workbook (newest release that has an Excel file): trade, housing price and rent, money, budget, household spending, Gini, CPI by decile and province, energy, stock market
`am_news`	Latest news and press releases of the Centre, or the text of one item

All 12 tools are annotated readOnlyHint: true.

How it works

  AI agent  ──MCP/stdio──▶  amar-mcp  ──HTTPS──▶  amar.org.ir  (release pages, Excel files)

The portal has no JSON API, so the server reads its catalog pages and downloads the Excel files that the portal itself offers, then parses them. It sends browser-like requests (Chrome TLS fingerprint), makes at most 3 concurrent requests, caches answers for 5 minutes and refuses files over 25 MB. The site's certificate chain is incomplete (it omits an intermediate); the server ships that public intermediate certificate to verify the connection normally.

FAQ

Why does it fail from outside Iran? amar.org.ir does not answer foreign IPs. Run it on an Iranian connection or set AMAR_MCP_PROXY.

Why is the newest month missing in `am_inflation`? The Centre publishes a PDF report first and updates the Excel series about a week later. The answer's newer_report names that release (use am_release for the PDF link); it also carries that month's national index and inflation, read from the PDF.

Are these the same as central-bank figures? No. These are the Statistical Centre's figures; the Central Bank of Iran publishes its own.

Is it affiliated with the Centre? No. It reads public pages and files, no login.

فارسی

amar-mcp یک سرور MCP غیررسمی و فقطخواندنی برای درگاه ملی آمار (مرکز آمار ایران، amar.org.ir) است. با آن میتوانید تورم و شاخص قیمت مصرفکننده (ماهانه، نقطهبهنقطه، متوسط ۱۲ ماه؛ به تفکیک گروه کالا، مناطق شهری و روستایی و استان)، نرخ بیکاری و مشارکت، جمعیت استانها و شهرستانها در سرشماری ۱۳۹۵، تقویم انتشار و هر جدول اکسل منتشرشده را بپرسید.

نصب: claude mcp add amar -- uvx amar-mcp (نیاز به uv). درگاه مرکز آمار فقط از داخل ایران پاسخ میدهد؛ سرور را روی اینترنت ایران اجرا کنید یا AMAR_MCP_PROXY را روی یک پروکسی ایرانی بگذارید.

Author: Sepehr Radmard (سپهر رادمرد), github.com/sepehr071, linkedin.com/in/sepehr-radmard. MIT license.

Statistical Centre of Iran

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Law & government datai

Common questions

Alternatives

Gerro: госзакупки для ИИ / Russian public procurement

Contract Compass

sanctions.io MCP by usefulapi

README from the maker

amar-mcp: Statistical Centre of Iran (مرکز آمار ایران) inflation, unemployment and census MCP server

For AI agents

Example

Quick start

Tools

How it works

FAQ

فارسی