# کدال (اطلاعیه‌ها و صورت‌های مالی) (Codal)

جستجوی اطلاعیه‌های کدال و خواندن صورت‌های مالی، گزارش فعالیت ماهانه، تصمیم‌های مجمع و سال مالی شرکت‌های بورسی و فرابورسی

- نوع: سرور MCP
- دسته: بازار مالی و ارز
- منبع: ساختهٔ بازارچه
- سازنده: sepehr071 (https://github.com/sepehr071)
- مجوز: MIT
- زبان: Python
- آخرین بررسی: 2026-11-04
- صفحه: https://mcpfarsi.ir/servers/codal/
- مخزن: https://github.com/sepehr071/codal-mcp
- وب‌سایت سرویس: https://www.codal.ir

## هشدارها

- فقط از IP ایران: فقط از داخل ایران (با IP ایران) کار می‌کند.
- اتصال با API غیررسمی: از راه رسمی وصل نمی‌شود و ممکن است ناگهان از کار بیفتد.

## نصب

- اجرا (stdio): `uvx codal-mcp`
- بدون نصب: از راه روتر MCP (https://mcp.mcpfarsi.ir/mcp، ورود با OAuth)؛ راهنما: https://mcpfarsi.ir/start/
- متغیر محیطی `CODAL_MCP_PROXY` (اختیاری): اختیاری: نشانی یک پراکسی HTTP با خروجی ایران (یا چند نشانی جداشده با ویرگول)، اگر کدال به درخواست‌ها جواب نداد

## ابزارها

- `cd_search_letters`: جستجوی اطلاعیه‌های کدال با نماد، گروه و نوع اطلاعیه، کلمه‌ای از عنوان، بازهٔ تاریخ شمسی، طول دوره یا شمارهٔ پیگیری؛ جدیدترین‌ها اول، ۲۰ مورد در هر صفحه
- `cd_letter`: خواندن متن یا جدول‌های یک اطلاعیه با شمارهٔ پیگیری، همراه با پیوند PDF، اکسل و پیوست‌ها؛ صورت‌های مالی برگه به برگه (سود و زیان، ترازنامه، جریان وجوه نقد…)
- `cd_company`: پیدا کردن شرکت یا صندوق با نماد یا نام، همراه با بازار، صنعت و نوع ناشر (ناشران غیربورسی هم هستند)
- `cd_letter_types`: فهرست ۱۱ گروه اطلاعیه و نوع‌های هر گروه، با شناسه‌ای که جستجو می‌گیرد
- `cd_financial_years`: تاریخ‌های پایان سال مالی یک شرکت به شمسی، جدیدترین اول

## نمونه سؤال‌ها

- آخرین صورت‌های مالی شش‌ماههٔ فولاد را پیدا کن و سود خالصش را با همین دورهٔ سال قبل مقایسه کن.
- ترازنامهٔ همان اطلاعیه را هم بخوان؛ بدهی‌های جاری شرکت نسبت به پایان سال قبل چه تغییری کرده؟
- گزارش‌های فعالیت ماهانهٔ ایران خودرو در سال ۱۴۰۵ را بیاور و فروش هر ماه را کنار هم بگذار.
- در آخرین مجمع عمومی عادی سالانهٔ فولاد چه تصمیم‌هایی گرفته شد و سود هر سهم چقدر تقسیم شد؟

## توضیحات

کدال سامانه‌ای است که شرکت‌های بورسی و فرابورسی صورت‌های مالی، گزارش فعالیت ماهانه، اطلاعات بااهمیت، دعوت و تصمیم‌های مجمع و افزایش سرمایه را در آن منتشر می‌کنند. این سرور به دستیار هوش مصنوعی شما اجازه می‌دهد اطلاعیه‌ها را با نماد، نوع، عنوان یا بازهٔ تاریخ پیدا کند و جدول‌های هر اطلاعیه را بخواند. مسیر معمول این است: اول شرکت را با `cd_company` پیدا می‌کند، بعد با `cd_search_letters` اطلاعیهٔ مورد نظر را می‌جوید و در آخر با `cd_letter` متن یا جدول آن را می‌خواند.

#### نکته‌ها

- فقط اطلاعات را می‌خواند: ورود به حساب و ثبت اطلاعیه ندارد. غیررسمی است (سازنده‌اش کدال یا سازمان بورس نیست) و ۵ قابلیت دارد.
- مبلغ‌ها همان‌طور که شرکت منتشر کرده برمی‌گردند، معمولاً به میلیون ریال؛ سود هر سهم به ریال است. تاریخ‌ها شمسی و به وقت تهران است.
- صورت مالی برگه به برگه خوانده می‌شود (سود و زیان، ترازنامه، جریان وجوه نقد و…). پیوست‌ها فقط فهرست می‌شوند و باز نمی‌شوند.
- قیمت سهم، نسبت‌های مالی و XBRL ندارد؛ دستیار نسبت‌ها را از ردیف‌های جدول حساب می‌کند. برای قیمت و معاملات روز، «بورس تهران و فرابورس» را کنارش نصب کنید.
- کدال معمولاً به درخواست‌های خارج از ایران جواب نمی‌دهد. با اینترنت ایران اجرا کنید یا یک پراکسی با خروجی ایران در `CODAL_MCP_PROXY` بگذارید (پراکسی سیستم نادیده گرفته می‌شود).
- کدال بعد از چند درخواست پشت سر هم خطای ۴۲۹ و کپچا نشان می‌دهد و ممکن است تا یک ساعت نشانی شما را مسدود کند. سرور درخواست‌ها را با فاصله می‌فرستد و بعد از هر مسدودی یک دقیقه صبر می‌کند؛ از دستیار بخواهید سؤال‌های دقیق و کم‌تعداد بپرسد.
- اطلاعات برای آگاهی است، نه توصیهٔ خرید و فروش سهام.