# بورس تهران (TSETMC)

قیمت لحظه‌ای سهام، دفتر سفارش، ورود و خروج پول حقیقی و حقوقی، دیده‌بان بازار و تاریخچه قیمت، از سایت مدیریت فناوری بورس

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

## هشدارها

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

## نصب

- اجرا (stdio): `uvx --from git+https://github.com/solitraderbusiness/tsetmc-mcp@v0.1.0 tsetmc-mcp`
- بدون نصب: از راه روتر MCP (https://mcp.mcpfarsi.ir/mcp، ورود با OAuth)؛ راهنما: https://mcpfarsi.ir/start/

## API بورس تهران

- REST API روتر MCP همین ابزار را برای اسکریپت و برنامه هم اجرا می‌کند: `GET https://mcpfarsi.ir/api/v1/tools?q=` قابلیت‌ها و آرگومان‌هایشان را برمی‌گرداند و `POST https://mcpfarsi.ir/api/v1/call` یکی را اجرا می‌کند. شناسهٔ سرور: `tsetmc`.
- اول ابزار را در داشبورد به ابزارهای خودتان اضافه کنید، بعد کلید API را در https://mcpfarsi.ir/dashboard/?tab=access بسازید و با `Authorization: Bearer <کلید>` بفرستید. هر اجرای موفق از سقف طرح کم می‌شود (https://mcpfarsi.ir/pricing/).

```sh
curl "https://mcpfarsi.ir/api/v1/tools?q=tsetmc&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST "https://mcpfarsi.ir/api/v1/call" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server": "tsetmc", "tool": "search_symbol", "arguments": {}}'
```

## ابزارها

- `search_symbol`: پیدا کردن کد یک نماد از روی نام آن
- `get_quote`: قیمت و آمار لحظه‌ای یک نماد: آخرین و پایانی، حجم و ارزش معاملات، EPS و P/E
- `get_order_book`: دفتر سفارش پنج‌سطحی (عرضه و تقاضا)
- `get_money_flow`: ورود و خروج پول حقیقی و حقوقی یک نماد
- `get_market_watch`: دیده‌بان بازار، با مرتب‌سازی و فیلتر درصد تغییر
- `screen`: فهرست‌های آماده: بیشترین رشد و افت، پرارزش‌ترین و پرحجم‌ترین معاملات، و شمار نمادهای مثبت و منفی
- `get_index_overview`: بازار در یک نگاه: شاخص کل، شاخص هم‌وزن و ارزش کل بازار
- `get_price_history`: تاریخچهٔ روزانهٔ قیمت و حجم یک نماد (تعدیل‌نشده)
- `market_status_tool`: باز یا بسته بودن بازار و ساعت معاملات
- `describe_fields`: معنی و واحد هر فیلد داده
- `run_filter`: اجرای فیلتر دلخواه روی کل بازار
- `run_saved_filter`: اجرای فیلتر ذخیره‌شده یا آماده، مثل خرید حقوقی، صف خرید و حجم مشکوک
- `filter_help`: راهنمای نوشتن فیلتر: متغیرها، عملگرها و فیلترهای آماده

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

- وضعیت امروز فولاد چطور است؟ پول حقیقی وارد شده؟
- امروز کدام نمادها صف خرید دارند؟
- امروز حقوقی‌ها بیشتر حجم کدام نمادها را خریده‌اند؟

## توضیحات

با این سرور، دستیار هوش مصنوعی شما می‌تواند داده‌های بورس تهران را بخواند و نمادها را بررسی کند. داده‌ها از سایت شرکت مدیریت فناوری بورس می‌آید.

#### نکته‌ها

- این داده‌ها برای تحلیل و یادگیری است و توصیه سرمایه‌گذاری نیست.
- به گفته راهنمای مخزن، از داخل ایران بدون تنظیم خاصی کار می‌کند.
- از خارج ایران به پراکسی با IP ایران نیاز دارد؛ یعنی اتصالی که از داخل ایران به اینترنت وصل می‌شود.
- سرور عمداً آهسته درخواست می‌فرستد (حدود ۱٫۵ درخواست در ثانیه)، چون سایت بورس درخواست زیاد را مسدود می‌کند. تنظیم‌های سرعت سرور را بالا نبرید.
