Read-only codal.ir: search disclosures of Iranian listed companies, read letters and statements.

GitHub stars
270

Install

/plugin install codal@iran-mcp

Run it inside Claude Code after adding the marketplace with /plugin marketplace add sepehr071/iran-mcp.

Contents

Discovered from source

Skills 1

Codal (کدال) Disclosures

Read-only codal.ir: search disclosures of Iranian listed companies, read letters and statements.

The tools below come from the codal-mcp MCP server. If they are not available, install it with claude mcp add codal -- uvx codal-mcp, or add "codal": {"command": "uvx", "args": ["codal-mcp"]} to the client's MCP servers config. It needs uv. Restart the session after installing.

Tools

  • cd_search_letters: Search codal.ir disclosures (letters) of Iranian listed companies, newest first, 20 per page.
  • cd_letter: Read one codal.ir letter: its text or tables, plus links to its page, PDF, Excel and attachments.
  • cd_company: Find companies and funds on codal.ir by symbol or name, with their market, industry and type.
  • cd_letter_types: List codal.ir letter groups, or the letter types of one group with the ids cd_search_letters takes.
  • cd_financial_years: List the fiscal year-end dates codal.ir knows for one company, newest first (Jalali).

Rules

  • Prices are Toman. Convert before comparing with a Rial figure from anywhere else.
  • Read-only: no login, basket, booking, order or payment. Give the user the link to finish on the site.
  • Keep request rates low. These are undocumented site APIs that can change or rate-limit.
  • On timeouts or HTTP 403 outside Iran, set CODAL_MCP_PROXY to an HTTP proxy with an Iranian IP.
  • Report amounts are as published, usually million Rial (see unit_note), not Toman. codal.ir blocks an IP for up to an hour after a burst: make few, targeted calls, and stop when a tool says it is rate limiting. It often answers only Iranian connections; outside Iran the user needs CODAL_MCP_PROXY.

Maintainer

Sepehr Radmard: open-source MCP servers for the Iranian web

Built and maintained by Sepehr Radmard (سپهر رادمرد): LinkedIn · GitHub. More servers for Iranian websites: iran-mcp.

MCP servers 1

Sponsors

Details

Marketplace
sepehr071/iran-mcp
Source
plugins/codal
Category
Stocks

More from sepehr071/iran-mcp

All 96