Qavanin MCP server
io.github.sepehr071/qavanin-mcp·v0.1.2Unofficial read-only qavanin.ir: search Iranian laws and regulations, read full text and status.
0 stars353 downloads/wk
Reviews
Write oneNobody has reviewed Qavanin yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Qavanin 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 Qavanin compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 90% of 3,470 Web search servers
- Downloads a week
- 353
- more than 80% of 827 Web search servers with a package
Install Qavanin in Claude Code, Cursor or VS Code
claude mcp add qavanin-mcp -- uvx qavanin-mcp
What the publisher says
From the Qavanin repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.sepehr071/qavanin-mcp -->
qavanin-mcp: Iranian laws and regulations MCP server for AI agents
Let your AI agent read Iranian law (قوانین و مقررات ایران). An unofficial, read-only MCP server for qavanin.ir (سامانه ملی قوانین و مقررات جمهوری اسلامی ایران), the national database of Iranian laws, regulations, court votes and legal opinions. Search about 168,000 documents by title or full text, read a law or a single article, see how an article was amended, and follow the regulations and court votes that cite it, all from Claude, Cursor or Copilot.
For AI agents · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development · Related · Disclaimer · License
For AI agents
iran-mcp catalog (TOOLS.md, servers.json, llms.txt).
- What: unofficial MCP server (model context protocol) for qavanin.ir, Iran's national laws and regulations database. Queries work in Persian (Arabic ي/ك and Persian ی/ک are equivalent); dates are Jalali YYYY/MM/DD.
- Install: uvx qavanin-mcp or claude mcp add qavanin -- uvx qavanin-mcp. Transport: stdio. Needs uv (Python 3.10+).
- Auth: none, no API key or account. Optional QAVANINMCPPROXY (HTTP proxy URL, or a comma-separated list tried in turn); system proxy settings are ignored.
- Access: read-only. No login, subscription or purchase calls exist, so no confirmation is needed before calling any tool.
- Tools: 7, all prefixed qv. Typical sequence: qvsearch -> qvlaw (with article) -> qvamendments -> qvarticlehistory.
- Units: dates are Jalali strings (1405/07/22); document ids (id, the site's IDS) are 20-digit strings, keep them as strings; text uses Persian ی/ک.
- Use when: looking up what an Iranian law, regulation, court ruling or legal opinion says, when it was approved and published, whether it was amended or repealed, and what cites it.
- Do not use when: the user needs legal advice or a binding interpretation. The site is a reference database; always say which version and status you read. Sections marked repealed or amended are not current text.
- Machine-readable: server.json and the
Why
Iranian legislation is spread over thousands of laws, by-laws, court votes and opinions, and a law's current text depends on later amendments. Answering "what does article 10 of the civil code say, was it ever amended, and which regulations cite it?" means a lot of searching on a slow, server-rendered site. With qavanin-mcp an agent does it in a few calls and returns only the relevant article instead of an 892 KB law.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Qavanin: common questions
- Is Qavanin MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Qavanin safety report
- How do I install Qavanin?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Qavanin need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is Qavanin maintained?
- The last commit was 12 days ago (2026-10-23). The latest release is v0.1.2.
- What can I use instead of Qavanin?
- Servers from other publishers that do the same job: Arxiv MCP server, Pubmed MCP server and Misakanet MCP server.
- How does Qavanin compare with other Web search MCP servers?
- safety score 92/100 (higher than 90% of 3,470 Web search servers); downloads a week 353 (more than 80% of 827 Web search servers with a package). Full comparison.
Alternatives to Qavanin
Same job from other publishers: the closest match first, then the best rated.
- ArxivSearch arXiv papers, download full text, semantic search, citation graphs, and alerts via MCP.not reviewedWidely usedA
- PubmedSearch PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms.not reviewedEstablishedA
- MisakanetFailure-memory layer for coding agents: search evidence-rated failure lessons by error text.not reviewedEstablishedA
- Chatroost — unofficial Telegram MCP serverUnofficial Telegram MCP server — read, search, reply and react in your own Telegram account.not reviewedEstablishedA
- AlzaUnofficial MCP server for Alza.cz: catalog search plus token-guarded account and checkout.not reviewedEstablishedB