Skip to main content

rasmio-mcp: Rasmio (رسمیو) Iranian company registry MCP server for AI agents

rasmio-mcp is an unofficial, read-only MCP server that gives AI agents Rasmio, the registry of Iranian companies.
Its 8 tools search companies with filters, open a company's registry profile (board, CEO, shareholders, licenses,
capital history, official gazette ads), read gazette ads, show the companies a person manages, and look up products,
trademarks, patents and industrial designs.
No API key or Rasmio account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

PyPI Python CI License: MIT

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


For AI agents

  • What: unofficial MCP server for rasmio.com, a registry of Iranian companies built from the official gazette (روزنامه رسمی), the company registration office and other public sources.
  • Install: uvx rasmio-mcp or claude mcp add rasmio -- uvx rasmio-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional RASMIO_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
  • Access: read-only. It cannot log in, subscribe or edit anything.
  • Tools: 8, all prefixed rs_. Typical sequences: rs_search_companies -> rs_company -> rs_person / rs_ad; rs_search(kind="products") -> rs_product -> rs_search_companies(product_category=...).
  • Use when: the user asks who runs or owns an Iranian company, its national id, registration number, capital, address, licenses or recent gazette notices; which companies a person is on the board of; who supplies a product; who owns a trademark.
  • Output: compact JSON. Money is Rial. Dates are Persian (1404/06/26). Text is Persian as the site has it.

Quick start

claude mcp add rasmio -- uvx rasmio-mcp

Other clients: run uvx rasmio-mcp as a stdio server.

Tools

Tool What it returns
rs_search_companies Companies by name or activity, filtered by province, city, status, legal form, size, capital, founding date, license, product category, brand/subsidiary/contract; sort by relevance, views, age or capital
rs_company One company: founding date, status, legal form, registration number, economic code, national id, capital, activity, addresses, signature rule, board and CEO, other officers, auditors, shareholders and stock portfolio (listed companies), licenses, brands, patents and designs, capital changes, government contracts, Codal statements, 5 latest gazette ads
rs_ad Full text of one official gazette ad
rs_search People, products, brands, patents and industrial designs, or everything at once
rs_person The companies a person manages, sits on the board of or audits, with dates and the gazette ad behind each role
rs_product A product's specs (HS and ISIC codes, brand, maker, country), category and comparable suppliers
rs_ip A trademark, patent or industrial design: numbers, date, owner, description
rs_options Ids for the filters: legal forms, licenses, product categories, brand classes, provinces and cities

Limits

  • Rasmio lets visitors without an account open only about 5 company profiles per IP address every 4 days. rs_company says so plainly when the limit is reached; search and the other tools keep working.
  • Sections Rasmio keeps for subscribers are not available: parent and subsidiary companies, the full ad archive (only the 5 latest ads are public), risk reports, the relationship graph.
  • Privacy: people's national codes in gazette texts are shortened to their first 6 digits, as the site shows them. Person contact details are never returned.
  • Not affiliated with Rasmio. Data is as public on rasmio.com; check official sources for legal decisions.

فارسی

rasmio-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای سایت رسمیو است: جستجوی شرکت‌ها با فیلتر (استان، وضعیت، نوع شرکت، سرمایه، تاریخ ثبت، مجوز)، پرونده‌ی شرکت (هیئت مدیره و مدیرعامل، سهام‌داران، مجوزها، تغییرات سرمایه، آخرین آگهی‌های روزنامه رسمی)، متن کامل آگهی‌ها، سمت‌های هر شخص در شرکت‌ها، محصولات و برندها. بدون حساب کاربری کار می‌کند؛ رسمیو برای کاربر مهمان حدود ۵ پرونده‌ی شرکت در هر ۴ روز به ازای هر IP نشان می‌دهد.

License

MIT. Made by Sepehr Radmard (github.com/sepehr071 · linkedin.com/in/sepehr-radmard).

Metadata

Release files for rasmio-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rasmio-mcp 0.1.0
File Size Uploaded Provenance Actions
rasmio_mcp-0.1.0.tar.gz 551.0 kB With provenance Details for rasmio_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for rasmio-mcp 0.1.0
File Interpreter ABI Platform Actions
rasmio_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for rasmio_mcp-0.1.0-py3-none-any.whl

Total release size: 578.8 kB

Release files / rasmio_mcp-0.1.0.tar.gz

Download URL rasmio_mcp-0.1.0.tar.gz
Size 551.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4870c1f8af47a4da3af24d0b3e1b40230fb648de139cd6fcc199cb356ce13280
BLAKE2b-256 checksum
How to use checksums
20c18826f909dee5f4930e02c3545496143f62cc5b60c5ebd4b165782f87fad8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.

Transparency log

Release files / rasmio_mcp-0.1.0-py3-none-any.whl

Download URL rasmio_mcp-0.1.0-py3-none-any.whl
Size 27.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
be976f8a4ff15763362b2b66915a019d5d0479504da07bff802666755a157f10
BLAKE2b-256 checksum
How to use checksums
8225709e1874279ec893aca315d41e90a5cba10cd255ebe86216d5a159847a51
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.

Transparency log

Security for rasmio-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for rasmio_mcp-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page