codal
/codal
Read-only codal.ir: search disclosures of Iranian listed companies, read letters and statements. Use when the user asks about Codal (کدال) Disclosures (codal.ir) or wants stock exchange quotes, company filings, funds, bonds or commodity exchange trades in Iran.
- Author
- sepehr071 ↗
- Repository
- iran-mcp ↗
- Licence
- MIT
- Last repository change
- 12.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 6
No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Read-only codal.ir: search disclosures of Iranian listed companies, read letters and statements. Use when the user asks about Codal (کدال) Disclosures (codal.ir) or wants stock exchange quotes, company filings, funds, bonds or commodity exchange trades in Iran.
Original author description
Read-only codal.ir: search disclosures of Iranian listed companies, read letters and statements. Use when the user asks about Codal (کدال) Disclosures (codal.ir) or wants stock exchange quotes, company filings, funds, bonds or commodity exchange trades in Iran.
How it works
- Tools
- Rules
- Maintainer
SKILL.md preview
---
name: codal
description: "Read-only codal.ir: search disclosures of Iranian listed companies, read letters and statements. Use when the user asks about Codal (کدال) Disclosures (codal.ir) or wants stock exchange quotes, company filings, funds, bonds or commodity exchange trades in Iran."
---
# 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](https://docs.astral.sh/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
<a href="https://www.linkedin.com/in/sepehr-radmard"><img src="https://raw.githubusercontent.com/sepehr071/iran-mcp/main/assets/author-banner.png" alt="Sepehr Radmard: open-source MCP servers for the Iranian web" width="100%"></a>
Built and maintained by **Sepehr Radmard** (سپهر رادمرد): [LinkedIn](https://www.linkedin.com/in/sepehr-radmard) · [GitHub](https://github.com/sepehr071). More servers for Iranian websites: [iran-mcp](https://github.com/sepehr071/iran-mcp).
Versions
The database has no other skills named codal.
Database snapshot: 13.11.2026 · package version 762b4e2d11b5 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90fipiran
Read-only Fipiran (fipiran.ir) data on Iranian mutual funds and ETFs: NAV, returns, size, managers. Use when the user asks about Fipiran Funds (fipiran.ir) or wants stock exchange quotes, company filings, funds, bonds or commodity exchange trades in Iran. - 90ime
Read-only Iran Mercantile Exchange (ime.co.ir): physical trades, supply, prices, market totals. Use when the user asks about Iran Mercantile Exchange (ime.co.ir) or wants stock exchange quotes, company filings, funds, bonds or commodity exchange trades in Iran. - 100connector-sec-edgar
Use when a lawyer, compliance professional, or due-diligence analyst needs to retrieve US public-company filings from the SEC's EDGAR database — including 10-K annual reports, 10-Q quarterly filings, 8-K current reports, S-1 registration statements, proxy statements, and… - 100company-fundamentals
Show a company's reported financials from regulatory filings - revenue, profit, EPS, margins, year-on-year growth, trailing four-quarter earnings and price-to-earnings - for NSE-listed Indian companies (quarterly results filed with the exchange) and US companies (SEC 10-K and… - 100tool-sec-edgar-us
Use when due diligence or research requires reviewing US public company filings — annual reports (10-K), quarterly reports (10-Q), material event disclosures (8-K), IPO prospectuses (S-1), proxy statements (DEF 14A), or beneficial ownership schedules (13D/G). Essential for… - 100capitoltrades-cli
Queries US congressional stock trades (STOCK Act disclosures) on capitoltrades.com via the cli-web-capitoltrades command-line tool — trades with rich filters, politician profiles and leaderboards, issuer lookup with price history, plus insight articles, buzz, and press. Use when…