Iran Tax MCP server
io.github.sepehr071/iran-tax-mcp·v0.1.2Unofficial read-only Iranian tax: goods IDs and VAT, activity codes, property values, tax laws.
0 stars352 downloads/wk
Reviews
Write oneNobody has reviewed Iran Tax yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Iran Tax tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.10 · 2026-10-24 · same rubric, same numbers if you re-run it
- Code scan9 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 1 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Iran Tax compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 95% of 48,255 servers
- Downloads a week
- 352
- more than 83% of 12,191 servers with a package
Install Iran Tax in Claude Code, Cursor or VS Code
claude mcp add iran-tax-mcp -- uvx iran-tax-mcp
What the publisher says
From the Iran Tax repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.sepehr071/iran-tax-mcp -->
iran-tax-mcp: Iranian tax MCP server for AI agents
Let your AI agent answer Iranian tax questions (مالیات) from the tax administration's own public systems. An unofficial, read-only MCP server over tax.gov.ir, the goods/service ID system stuffid.tax.gov.ir and the tax regulation database regulation.tax.gov.ir: e-invoice goods IDs and VAT rates, activity codes, property transaction values, tax laws, circulars and rulings, and the official FAQ.
For AI agents · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development
For AI agents
iran-mcp catalog.
- What: unofficial MCP server (model context protocol) for public services of the Iranian National Tax Administration (سازمان امور مالیاتی کشور): tax.gov.ir, stuffid.tax.gov.ir and regulation.tax.gov.ir. Answers are Persian text.
- Install: uvx iran-tax-mcp or claude mcp add iran-tax -- uvx iran-tax-mcp. Transport: stdio. Needs uv (Python 3.10+).
- Auth: none, no API key or account. Optional IRANTAXMCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored. The sites often refuse foreign IPs: outside Iran, use a proxy that exits in Iran.
- Access: read-only. No login, filing, invoicing or payment, so no confirmation is needed before calling any tool.
- Tools: 6, all prefixed tx: txgoodssearch, txactivitycodes, txpropertyvalue, txregulationssearch, txregulationtext, txfaqsearch. For a law question, call txregulationssearch first, then pass the hit's id and type to txregulation_text.
- Use when: a company or accountant needs an e-invoice goods/service ID and its VAT rate, an activity code and its VAT stage, the official property value at an address, the text of a tax law article, a circular (بخشنامه) or ruling, or an official FAQ answer.
- Do not use when: the task needs a taxpayer's own data (returns, invoices, debts, economic-code lookups). Those need a login or a captcha and are not offered.
- Output: compact JSON. Dates and years are Jalali (1405/07/27, 1404). Money is rial as integers. Null and empty fields are omitted. Replies stay under ~15 KB: long texts come in parts of 6000 characters, list sizes are capped.
- Network: the first txgoodssearch for a phrase takes 15-30 s (cached for an hour).
- Machine-readable: server.json and the
Why
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Iran Tax: common questions
- Is Iran Tax MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Iran Tax safety report
- How do I install Iran Tax?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Iran Tax need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is Iran Tax maintained?
- The last commit was 12 days ago (2026-10-23). The latest release is v0.1.2.
- How does Iran Tax compare with other MCP servers?
- safety score 92/100 (higher than 95% of 48,255 servers); downloads a week 352 (more than 83% of 12,191 servers with a package). Full comparison.