amar-mcp 0.1.0__tar.gz

amar_mcp-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,42 @@
+name: Bug report
+description: A tool failed or returned wrong data
+labels: [bug]
+body:
+  - type: input
+    id: tool
+    attributes:
+      label: Tool
+      description: Which tool, e.g. bl_search
+    validations:
+      required: true
+  - type: textarea
+    id: input
+    attributes:
+      label: Arguments and result
+      description: The arguments the agent sent and the error or wrong output. Remove anything personal.
+      render: json
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What you expected
+      description: e.g. what amar.org.ir shows for the same query
+  - type: input
+    id: client
+    attributes:
+      label: MCP client and OS
+      placeholder: Claude Desktop 1.x on Windows 11
+  - type: dropdown
+    id: network
+    attributes:
+      label: Network
+      options:
+        - Direct connection
+        - VPN or proxy
+        - AMAR_MCP_PROXY set
+  - type: input
+    id: version
+    attributes:
+      label: amar-mcp version
+      placeholder: "0.1.0"

amar_mcp-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Question or idea
+    url: https://github.com/sepehr071/amar-mcp/discussions
+    about: Ask how to use it or suggest a new tool

amar_mcp-0.1.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: monthly

amar_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: ${{ matrix.python }}
+      - run: uv sync --locked
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run pytest -q

amar_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,51 @@
+name: Publish
+
+# Tag a release (git tag v0.1.0 && git push --tags) after bumping the version in
+# pyproject.toml and server.json.
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # PyPI trusted publishing
+      contents: write  # GitHub Release
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+      - name: Check versions match the tag
+        run: |
+          TAG=${GITHUB_REF_NAME#v}
+          grep -q "^version = \"$TAG\"" pyproject.toml
+          test "$(jq -r .version server.json)" = "$TAG"
+          test "$(jq -r '.packages[0].version' server.json)" = "$TAG"
+      - run: uv sync --locked && uv run pytest -q
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+      - run: gh release create "$GITHUB_REF_NAME" dist/* --generate-notes --title "$GITHUB_REF_NAME"
+        env:
+          GH_TOKEN: ${{ github.token }}
+
+  mcp-registry:
+    needs: pypi
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # MCP Registry login via GitHub OIDC
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+      - name: Wait for PyPI to serve the new version
+        run: |
+          for i in $(seq 1 30); do
+            curl -sf "https://pypi.org/pypi/amar-mcp/${GITHUB_REF_NAME#v}/json" >/dev/null && exit 0
+            sleep 10
+          done
+          exit 1
+      - name: Install mcp-publisher
+        run: |
+          curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.1/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
+      - run: ./mcp-publisher login github-oidc
+      - run: ./mcp-publisher publish

amar_mcp-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.venv/
+__pycache__/
+*.pyc
+dist/
+.pytest_cache/
+.ruff_cache/

amar_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sepehr Radmard
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

amar_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.5
+Name: amar-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for the Statistical Centre of Iran (amar.org.ir): CPI inflation, unemployment, population, release tables.
+Project-URL: Homepage, https://github.com/sepehr071/amar-mcp
+Project-URL: Issues, https://github.com/sepehr071/amar-mcp/issues
+Project-URL: Website, https://mcpfarsi.ir/
+Author-email: Sepehr Radmard <sepehrr80@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: amar,census,claude,cpi,inflation,iran,mcp,model-context-protocol,open-data,persian,population,statistical-centre-of-iran,statistics,unemployment
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.10
+Requires-Dist: curl-cffi>=0.16.3
+Requires-Dist: httpx-curl-cffi>=0.1.5
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<3,>=2.2
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: pypdf>=5
+Requires-Dist: xlrd>=2.0
+Description-Content-Type: text/markdown
+
+<!-- mcp-name: io.github.sepehr071/amar-mcp -->
+
+# 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).**<br>
+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.<br>
+No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
+
+[![PyPI](https://img.shields.io/pypi/v/amar-mcp?color=2563eb)](https://pypi.org/project/amar-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/amar-mcp)](https://pypi.org/project/amar-mcp/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/amar-mcp/blob/main/LICENSE)
+
+[For AI agents](#for-ai-agents) · [Quick start](#quick-start) · [Tools](#tools) · [FAQ](#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](https://docs.astral.sh/uv/getting-started/installation/) (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`](https://github.com/sepehr071/amar-mcp/blob/main/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%.
+
+<sub>Numbers from a live call on 2026-11-01.</sub>
+
+Other prompts: "unemployment rate by quarter", "population of Yazd province and its counties", "inflation in Fars province", "when is the next CPI release", <span dir="rtl">تورم نقطه به نقطه مسکن شهری چقدر است؟</span>, <span dir="rtl">نرخ بیکاری آخرین فصل؟</span>
+
+## Quick start
+
+You need [uv](https://docs.astral.sh/uv/getting-started/installation/). No API key or account.
+
+**Claude Code:** `claude mcp add amar -- uvx amar-mcp`
+
+**Claude Desktop, Cursor, Windsurf, Gemini CLI:** add
+
+```json
+{
+  "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 |
+| `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: 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
+
+```text
+  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](https://docs.astral.sh/uv/getting-started/installation/)). درگاه مرکز آمار فقط از داخل ایران پاسخ می‌دهد؛ سرور را روی اینترنت ایران اجرا کنید یا `AMAR_MCP_PROXY` را روی یک پروکسی ایرانی بگذارید.
+
+<sub>Author: Sepehr Radmard (سپهر رادمرد), [github.com/sepehr071](https://github.com/sepehr071), [linkedin.com/in/sepehr-radmard](https://linkedin.com/in/sepehr-radmard). MIT license.</sub>

amar_mcp-0.1.0/README.md

@@ -0,0 +1,108 @@
+<!-- mcp-name: io.github.sepehr071/amar-mcp -->
+
+# 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).**<br>
+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.<br>
+No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
+
+[![PyPI](https://img.shields.io/pypi/v/amar-mcp?color=2563eb)](https://pypi.org/project/amar-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/amar-mcp)](https://pypi.org/project/amar-mcp/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/amar-mcp/blob/main/LICENSE)
+
+[For AI agents](#for-ai-agents) · [Quick start](#quick-start) · [Tools](#tools) · [FAQ](#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](https://docs.astral.sh/uv/getting-started/installation/) (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`](https://github.com/sepehr071/amar-mcp/blob/main/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%.
+
+<sub>Numbers from a live call on 2026-11-01.</sub>
+
+Other prompts: "unemployment rate by quarter", "population of Yazd province and its counties", "inflation in Fars province", "when is the next CPI release", <span dir="rtl">تورم نقطه به نقطه مسکن شهری چقدر است؟</span>, <span dir="rtl">نرخ بیکاری آخرین فصل؟</span>
+
+## Quick start
+
+You need [uv](https://docs.astral.sh/uv/getting-started/installation/). No API key or account.
+
+**Claude Code:** `claude mcp add amar -- uvx amar-mcp`
+
+**Claude Desktop, Cursor, Windsurf, Gemini CLI:** add
+
+```json
+{
+  "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 |
+| `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: 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
+
+```text
+  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](https://docs.astral.sh/uv/getting-started/installation/)). درگاه مرکز آمار فقط از داخل ایران پاسخ می‌دهد؛ سرور را روی اینترنت ایران اجرا کنید یا `AMAR_MCP_PROXY` را روی یک پروکسی ایرانی بگذارید.
+
+<sub>Author: Sepehr Radmard (سپهر رادمرد), [github.com/sepehr071](https://github.com/sepehr071), [linkedin.com/in/sepehr-radmard](https://linkedin.com/in/sepehr-radmard). MIT license.</sub>

amar_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[project]
+name = "amar-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for the Statistical Centre of Iran (amar.org.ir): CPI inflation, unemployment, population, release tables."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Sepehr Radmard", email = "sepehrr80@gmail.com" }]
+requires-python = ">=3.10"
+keywords = ["mcp", "model-context-protocol", "amar", "statistical-centre-of-iran", "iran", "inflation", "cpi", "unemployment", "census", "population", "statistics", "open-data", "claude", "persian"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+]
+dependencies = [
+    "mcp>=2.2,<3",
+    "httpx>=0.27",
+    "httpx-curl-cffi>=0.1.5",
+    "curl-cffi>=0.16.3",
+    "openpyxl>=3.1",
+    "pypdf>=5",
+    "xlrd>=2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/sepehr071/amar-mcp"
+Issues = "https://github.com/sepehr071/amar-mcp/issues"
+Website = "https://mcpfarsi.ir/"
+
+[project.scripts]
+amar-mcp = "amar_mcp.server:main"
+
+[dependency-groups]
+dev = ["pytest>=8", "ruff>=0.6"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-m 'not live'"
+markers = ["live: calls the real amar.org.ir site (run with -m live)"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]
+ignore = ["E501"]  # long Field(description=...) strings read better on one line

amar_mcp-0.1.0/server.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.sepehr071/amar-mcp",
+  "title": "Statistical Centre of Iran",
+  "description": "Read-only Statistical Centre of Iran (amar.org.ir): CPI inflation, unemployment, census, any table.",
+  "repository": {
+    "url": "https://github.com/sepehr071/amar-mcp",
+    "source": "github"
+  },
+  "websiteUrl": "https://github.com/sepehr071/amar-mcp",
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "pypi",
+      "registryBaseUrl": "https://pypi.org",
+      "identifier": "amar-mcp",
+      "version": "0.1.0",
+      "runtimeHint": "uvx",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "AMAR_MCP_PROXY",
+          "description": "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.",
+          "isRequired": false,
+          "isSecret": false
+        }
+      ]
+    }
+  ]
+}

amar_mcp-0.1.0/src/amar_mcp/__init__.py

@@ -0,0 +1,5 @@
+"""Unofficial MCP server for amar.org.ir, the Statistical Centre of Iran: inflation, labour force, population and releases."""
+
+from importlib.metadata import version
+
+__version__ = version("amar-mcp")

amar_mcp-0.1.0/src/amar_mcp/certs/certum-dv-tls-g2-r39.pem

@@ -0,0 +1,38 @@
+-----BEGIN CERTIFICATE-----
+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
+8FpPkganuCwy++7umTkM7+Q=
+-----END CERTIFICATE-----