SolidInvoice
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
Unofficial read-only Iranian tax: goods IDs and VAT, activity codes, property values, tax laws.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 12/100 |
Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Iran Tax. Follow https://mcp.popnx.com/i/sepehr071-iran-tax-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 2/3 checks · Runs on your computer · ✓ Commands checked Nov 18, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Iran Tax for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "iran-tax": { "command": "uvx", "args": [ "iran-tax-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Iran Tax tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
SettingsDeveloperEdit Config
{
"mcpServers": {
"iran-tax": {
"command": "uvx",
"args": [
"iran-tax-mcp"
]
}
}
}Use Iran Tax and tell me what you can do for me, then show me one thing✓ If Claude says it is using Iran Tax or shows a Iran Tax tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
IRAN_TAX_MCP_PROXY Optional HTTP proxy URL. 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.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Iran Tax yet
Iran Tax runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Iran Tax
B · Others in Accounting, finance & tax that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
Install Python (uv) on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Iran Tax for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user iran-tax -- uvx iran-tax-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Iran Tax tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user iran-tax -- uvx iran-tax-mcpYou should see Iran Tax listed as connected
Use Iran Tax and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Iran Tax or shows a Iran Tax tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
IRAN_TAX_MCP_PROXY Optional HTTP proxy URL. 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.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
Install Python (uv) on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Iran Tax for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "iran-tax": { "command": "uvx", "args": [ "iran-tax-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Iran Tax tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Use Iran Tax and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Iran Tax or shows a Iran Tax tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
IRAN_TAX_MCP_PROXY Optional HTTP proxy URL. 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.Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
Install Python (uv) on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Iran Tax for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "iran-tax": { "type": "stdio", "command": "uvx", "args": [ "iran-tax-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Iran Tax tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Use Iran Tax and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Iran Tax or shows a Iran Tax tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
IRAN_TAX_MCP_PROXY Optional HTTP proxy URL. 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.Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Claude Code
claude mcp add --scope user iran-tax -- uvx iran-tax-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"iran-tax": {
"command": "uvx",
"args": [
"iran-tax-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"iran-tax": {
"command": "uvx",
"args": [
"iran-tax-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"iran-tax": {
"type": "stdio",
"command": "uvx",
"args": [
"iran-tax-mcp"
]
}
}
}IRAN_TAX_MCP_PROXY envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
pypi: iran-tax-mcpBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
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 20, 2026
The registry name was verified with the GitHub account sepehr071, which owns the repo
Code last changed 2 days ago
GitHub could not identify the licence type; open the file to check
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked yet
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/sepehr071-iran-tax-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 2 of 3 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.
The registry does not list a required key, though some servers ask you to sign in on first use.
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).
The GitHub repo last changed 2 days ago, and the latest version (0.2.2) reached the registry 2 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
In the same category: SolidInvoice, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP, Twelve Data
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.
Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.
48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.
| This one Iran Tax | SolidInvoice | Journalit | Beancount.io | Tapetide - Indian Stock Market MCP | Twelve Data | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer | Runs in the cloud, nothing to install |
| Needs a key | No | No | No | No | Yes | No |
| Add with + in Claude | No | No | No | No | No | Yes |
| Basic checks | 2/3 | 4/6 | 4/4 | 4/4 | 5/5 | 4/4 |
| License | NOASSERTION | MIT | NOASSERTION | MIT | MIT | – |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
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.
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 · Good to know · FAQ · Configuration · فارسی · Development
uvx iran-tax-mcp or claude mcp add iran-tax -- uvx iran-tax-mcp. Transport: stdio. Needs uv (Python 3.10+).IRAN_TAX_MCP_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.tx_: tx_goods_search, tx_activity_codes, tx_property_value, tx_regulations_search, tx_regulation_text, tx_faq_search. For a law question, call tx_regulations_search first, then pass the hit's id and type to tx_regulation_text.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.tx_goods_search for a phrase takes 15-30 s (cached for an hour).server.json and the iran-mcp catalog.Iranian tax answers live on three different government sites, each with its own forms, postbacks and search screens. Finding the VAT rate of a product means a slow ID search; finding article 169 bis of the direct tax law means scrolling a 1.6 MB page. With iran-tax-mcp an agent runs the search, picks the right document and returns just the part you asked for.
You: What is the VAT treatment of laptops on the e-invoice system?
Agent: *calls*
tx_goods_search(query="لپ تاپ", limit=5)
It returns the best-ranked active general goods IDs with their VAT rate, type and validity dates.
Every reply is trimmed to stay under about 15 KB, so it does not flood the agent's context.
ماده 169 مکرر, with the official PDF linkExample prompts:
You need uv. No API key or account. Outside Iran, see the proxy note in Good to know.
Claude Code
claude mcp add iran-tax -- uvx iran-tax-mcp
Claude Desktop
Settings → Developer → Edit Config, then add:
{
"mcpServers": { "iran-tax": { "command": "uvx", "args": ["iran-tax-mcp"] } } }
</details>
Cursor
Add the Claude Desktop block above to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).
VS Code (Copilot agent mode)
Click Install in VS Code above, or add to .vscode/mcp.json:
{
"servers": { "iran-tax": { "type": "stdio", "command": "uvx", "args": ["iran-tax-mcp"] } } }
</details>
Codex CLI
codex mcp add iran-tax -- uvx iran-tax-mcp
Or in ~/.codex/config.toml:
[mcp_servers.iran-tax]
command = "uvx" args = ["iran-tax-mcp"]
</details>
Gemini CLI
Add to ~/.gemini/settings.json:
{
"mcpServers": { "iran-tax": { "command": "uvx", "args": ["iran-tax-mcp"] } } }
</details>
Windsurf
Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.
Anything else
It is a standard stdio MCP server: run uvx iran-tax-mcp, or pip install iran-tax-mcp and run iran-tax-mcp.
| Tool | What it does |
|---|---|
tx_goods_search | E-invoice goods/service IDs (شناسه کالا و خدمات) with VAT rate, type and validity, by description or 13-digit ID (query, kind, general_only, limit 1-20). First search for a phrase takes 15-30 s; cached for an hour. |
tx_activity_codes | Activity codes (اینتاکد) with VAT stage, business group and official profit ratios (query, year, commercial, limit 1-20). |
tx_property_value | Official property transaction value (ارزش معاملاتی) and rent value per m², booklet block and row, and the tax offices for a point (latitude, longitude, year). |
tx_regulations_search | Search tax laws, regulations and circulars, rulings, opinions, correspondence and glossary, newest first (query, type, title_only, page). |
tx_regulation_text | Full text of one document, or one article of it such as ماده 169 مکرر, with metadata and the official PDF link (id, type, article, part). |
tx_faq_search | The tax administration's FAQ: matching questions with links (query). |
All 6 tools are annotated readOnlyHint: true.
IRAN_TAX_MCP_PROXY to an HTTP proxy with an Iranian exit. System proxy variables are ignored on purpose.part, or for a single article. Documents are cached for an hour.Is there an API or MCP server for Iranian tax data?
The tax administration's public sites have no documented open API for these lookups. iran-tax-mcp is an unofficial MCP server with 6 read-only tools that reads the public pages of tax.gov.ir, stuffid.tax.gov.ir and regulation.tax.gov.ir and returns compact JSON for AI agents.
Does it work outside Iran?
Often not: Iranian government sites drop many foreign connections. It was built and tested on a direct Iranian connection. Set IRAN_TAX_MCP_PROXY to a proxy in Iran if calls fail to connect.
Why no economic-code (شماره اقتصادی) or invalid-company lookup?
On tax.gov.ir those forms need a captcha, and the e-invoice API needs the taxpayer's signed key. This server only uses what is public without either.
Why is the first goods search slow?
The ID system answers a search by building a file (15-30 s for a broad phrase such as «لپ تاپ»). The server downloads it once, ranks it (active general IDs first) and keeps it for an hour, so repeats are fast.
How do I get the text of a specific law article?
Call tx_regulations_search to find the document, then tx_regulation_text with its id and type, and article set to something like ماده 169 مکرر.
Are the activity-code numbers tax rates?
No. The two numeric columns are the official profit ratios (نسبت سود فعالیت and نسبت سود ناویژه به فروش).
Can it file returns, issue invoices or pay taxes?
No. It has no login and no write calls, it only reads public information. Nothing it returns is tax or legal advice.
How do I debug what the agent sees?
npx @modelcontextprotocol/inspector uvx iran-tax-mcp