Skip to content
Skills Library
Finance & accounting · Research

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.

Repository
iran-mcp ↗
Licence
MIT
Last repository change
12.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
6
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

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

  1. Tools
  2. Rules
  3. Maintainer
Original SKILL.md headings · 29 lines, 299 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.