mcpField
O
Official Gazette of Iran

Official Gazette of Iran

Local
github.comLegal & Government0Updated 3d ago
RepositoryVisit website

About Official Gazette of Iran

Official Gazette of Iran is an unofficial, read-only MCP server for AI agents and researchers looking up Iranian laws, regulations, and rulings. It searches gazette records and retrieves full text, with no account or API key required.

Key features

  1. 01List recent laws and rulings
  2. 02Search by text, date, group, or approver
  3. 03Retrieve full law or ruling text
  4. 04List licensed currency exchange offices

Use cases

  1. 01Check recently published Iranian laws
  2. 02Find a ruling by topic or date
  3. 03Read the text of a regulation
  4. 04Look up licensed exchange offices

MCP support

Exposes five read-only tools to MCP clients for searching and reading gazette material and listing licensed exchange offices.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "sepehr071-rrk": {
      "command": "uvx",
      "args": [
        "rrk-mcp"
      ],
      "env": {
        "RRK_MCP_PROXY": "<RRK_MCP_PROXY>"
      }
    }
  }
}
Run commanduvx rrk-mcp
Environment variables to set
RRK_MCP_PROXYOptional HTTP proxy URL for the rrk.ir requests; system proxy settings are ignored.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypirrk-mcp0.2.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

rrk-mcp: Official Gazette of Iran (روزنامه رسمی) laws and rulings MCP server for AI agents

rrk-mcp is an unofficial, read-only MCP server for the laws and regulations database of the Official Gazette of Iran (rrk.ir).
Its 5 tools list the newest laws, search them by title, full text, group, approver, special issue number or gazette date,
read the full text of a law, court ruling or regulation, and list the licensed exchange offices. No API key or account is needed.

PyPI Python License: MIT

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

For AI agents

  • What: unofficial MCP server for rrk.ir, the Official Gazette: laws (قوانین), regulations (آیین‌نامه، مصوبات), Court of Administrative Justice rulings (آرای دیوان عدالت اداری) and other texts published in the gazette since 1285 (2026 = 1405).
  • Install: uvx rrk-mcp or claude mcp add rrk -- uvx rrk-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional RRK_MCP_PROXY (HTTP proxy URL); system proxy settings are ignored.
  • Access: read-only; no confirmation is needed before calling any tool.
  • Tools: 5, all prefixed rk_. Typical sequence: rk_law_filters (optional) -> rk_search_laws -> rk_law_text.
  • Use when: the user asks what the gazette published lately, wants a law or ruling by topic or date, or needs the text of one.
  • Do not use when: the user wants company registration notices (founding, capital change, board change, liquidation). rrk.ir does not offer those in an open search, so this server cannot look companies up.
  • Output: compact JSON, Persian text. Dates are Jalali (1405/08/09).

Quick start

claude mcp add rrk -- uvx rrk-mcp

Any other client: run uvx rrk-mcp as a stdio MCP server ({"command": "uvx", "args": ["rrk-mcp"]}).

Tools

ToolWhat it does
rk_latest_lawsList the newest laws, rulings and regulations in the Official Gazette, newest first
rk_search_lawsSearch laws by title words, full-text words, law group, approver, special issue number or Jalali gazette date range
rk_law_filtersList the law groups (categories) and approving authorities to filter by
rk_law_textRead one law's approver, gazette number and date, and full text (long texts in parts)
rk_exchange_officesList the licensed currency exchange offices (location, phone, address; a field the portal leaves empty is null) by province and city

All 5 tools are annotated readOnlyHint: true.

Limits

  • Laws only. Company notices (آگهی‌های ثبتی) sit behind rrk.ir's paid data service and login, so they are left out.
  • The portal is slow (a full-text search can take 10 seconds) and shares one session; the server keeps one session and reuses it.
  • rk_law_text works with any code, but a code the session has not listed is located by paging the list (10-60 s, and codes below about 10,000 may not be found). Majlis debates (group 64) have a title only; the debate text is a PDF behind login.
  • Gazette PDFs and the shop need login or payment, and are left out.
  • Persian ی and ک are converted to the Arabic ي and ك the portal stores; you can type either.

Development

uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q
uv run python -m pytest -m live -q

فارسی

rrk-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای پایگاه قوانین و مقررات روزنامه رسمی (rrk.ir) است: فهرست جدیدترین قوانین، جستجو بر اساس عنوان، متن، شماره ویژه‌نامه و تاریخ روزنامه، فیلتر بر اساس گروه قوانین و مرجع تصویب، خواندن متن کامل قانون یا رأی، و فهرست صرافی‌های مجاز بانک مرکزی. جستجوی آگهی‌های ثبتی شرکت‌ها در سایت به‌صورت باز وجود ندارد و پشتیبانی نمی‌شود.

Made by Sepehr Radmard (سپهر رادمرد) · github.com/sepehr071 · linkedin.com/in/sepehr-radmard

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.