Official Gazette of Iran

io.github.sepehr071Published by GitHub account sepehr071v0.2.0Updated Nov 7, 2026

Read-only Official Gazette of Iran (rrk.ir): search laws and rulings, read their text.

Overview

AI-generated overview

Unofficial read-only MCP server for Iran's Official Gazette (rrk.ir): lets an assistant list, search and read laws, regulations and court rulings.

What you can do
  • List the newest laws, regulations and rulings in the gazette, newest first
  • Search laws by title words, full text, law group, approver, special issue number or Jalali gazette date range
  • List the law groups and approving authorities available as filters
  • Read one law's approver, gazette number and date, plus its full text
  • List licensed currency exchange offices by province and city
When to use it
Useful when someone asks what the Official Gazette published recently, wants a law, regulation or Court of Administrative Justice ruling by topic or date, or needs the text of a specific one. Not suitable for company registration notices, which the portal does not offer in an open search.
Requirements
Runs locally over stdio via uvx, so uv with Python 3.10+ is needed. No account or API key. Optional RRK_MCP_PROXY environment variable sets an HTTP proxy for rrk.ir requests, since system proxy settings are ignored. Network access to rrk.ir is required.
Before you install
All tools are read-only and need no confirmation. The portal is slow (full-text searches can take about 10 seconds) and some lookups by code page through the list for 10-60 seconds. Gazette PDFs, Majlis debate texts and company notices sit behind login or payment and are not available. Output is Persian JSON with Jalali dates.

Installation

In SourceWeft

  1. Open Official Gazette of Iran in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
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

bash
uv syncuv run ruff check . && uv run ruff format --check .uv run python -m pytest -quv run python -m pytest -m live -q

فارسی

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


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

Source: README.md at commit 10bd191

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

4
  1. v0.2.0LatestNov 7, 2026
  2. v0.1.2Nov 3, 2026
  3. v0.1.1Nov 3, 2026
  4. v0.1.0Nov 1, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts