{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_8444zeh3x78u","handle":"codal-mcp","url":"https://wellknown.network/agents/codal-mcp","links":{"self":"https://wellknown.network/agents/codal-mcp/record.json","html":"https://wellknown.network/agents/codal-mcp","markdown":"https://wellknown.network/agents/codal-mcp/record.md","api":"https://wellknown.network/api/v1/agents/codal-mcp","status":"https://wellknown.network/api/v1/agents/codal-mcp/status","claim":"https://wellknown.network/agents/codal-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/codal-mcp/claim.json","badge":"https://wellknown.network/agents/codal-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/codal-mcp/history","tools":"https://wellknown.network/api/v1/agents/codal-mcp/tools"},"ard":{"identifier":"urn:air::server:codal-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"codal-mcp","summary":"Unofficial read-only MCP server for codal.ir (کدال): disclosures, letters and financial statements of Iranian listed companies.","description":"<!-- mcp-name: io.github.sepehr071/codal-mcp -->\n\n<div align=\"center\">\n\n<img src=\"https://raw.githubusercontent.com/sepehr071/codal-mcp/main/.github/banner.png\" alt=\"codal-mcp: unofficial Codal (کدال) MCP server that reads Iranian listed companies' disclosures and financial statements for Claude, Cursor and Copilot\" width=\"100%\">\n\n# codal-mcp: Codal (کدال) disclosure and financial statement MCP server for AI agents\n\n**codal-mcp lets an AI agent search and read Codal, the official disclosure system of Iranian listed companies.**<br>\nCodal (codal.ir, سامانه جامع اطلاع‌رسانی ناشران) is where companies and funds on the Tehran Stock Exchange, Iran Fara Bourse<br>\nand the other Iranian exchanges publish financial statements, monthly activity reports, meeting decisions and material news.<br>\ncodal-mcp is an unofficial, read-only MCP server with 5 tools that turns those letters into text and tables for Claude, Cursor or Copilot.\n\n[![PyPI](https://img.shields.io/pypi/v/codal-mcp?color=2563eb)](https://pypi.org/project/codal-mcp/)\n[![Python](https://img.shields.io/pypi/pyversions/codal-mcp)](https://pypi.org/project/codal-mcp/)\n[![CI](https://github.com/sepehr071/codal-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/sepehr071/codal-mcp/actions/workflows/ci.yml)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.sepehr071%2Fcodal--mcp-7c3aed)](https://registry.modelcontextprotocol.io/?q=codal-mcp)\n[![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/codal-mcp/blob/main/LICENSE)\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_codal--mcp-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=codal&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22codal-mcp%22%5D%7D)\n\n[For AI agents](#for-ai-agents) · [Quick start](#quick-start) · [What it can do](#what-it-can-do) · [Tools](#tools) · [FAQ](#faq) · [فارسی](#فارسی)\n\n</div>\n\n---…","publisher":null,"homepage":"https://github.com/sepehr071/codal-mcp","repository":"https://github.com/sepehr071/codal-mcp","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["annual-report","bourse","codal","codal-ir","disclosures","eps","financial-statements","iran","listed-companies","mcp","model-context-protocol","persian","tehran-stock-exchange","tse"],"pricing":null,"endpoints":[{"url":"pypi:codal-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"analytics.reporting","name":"Reporting & Dashboards","confidence":1,"provenance":"derived"},{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"derived"}],"categories":["analytics","finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"codal-mcp","registry":"pypi","observedAt":"2026-11-03T00:27:04.453Z","publishedAt":"2026-11-02T06:25:45.233316Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"codal-mcp","url":"https://pypi.org/project/codal-mcp/","firstSeenAt":"2026-11-03T00:25:09.112Z","fetchedAt":"2026-11-03T00:25:09.112Z","normalizedAt":"2026-11-03T00:25:09.112Z"}]},"firstSeenAt":"2026-11-03T00:25:09.112Z","updatedAt":"2026-11-03T00:27:04.453Z"}