سرور MCP برای عامل‌های هوش مصنوعی

بلاک‌لنز یک سرور MCP ارائه می‌دهد که به عامل‌های هوش مصنوعی اجازه می‌دهد تحلیل‌های on-chain را مستقیماً در حین گفتگو کوئری بزنند. به جای کپی-پیست پاسخ‌های API، عامل شما ابزارهای موجود را کشف کرده و به‌صورت خودکار آن‌ها را فراخوانی می‌کند.

MCP چیست؟

Model Context Protocol (MCP) یک استاندارد باز است که توسط Anthropic ایجاد شده و نحوه‌ی اتصال برنامه‌های هوش مصنوعی به منابع داده و ابزارهای خارجی را تعریف می‌کند. آن را مانند یک آداپتور جهانی در نظر بگیرید — هر عامل سازگار با MCP (مانند Claude، Cursor، Windsurf و غیره) می‌تواند بدون نیاز به کد یکپارچه‌سازی سفارشی به هر سرور MCP متصل شود.

با MCP، عامل صرفاً داده را نمی‌خواند — بلکه می‌تواند ابزارهای موجود را کشف کند، پارامترهای آن‌ها را بفهمد و آن‌ها را با آرگومان‌های درست فراخوانی کند. این موضوع تعاملات را بسیار طبیعی‌تر از ساختن دستی فراخوانی‌های API می‌کند.

دسترسی از راه دور (بدون نیاز به نصب)

سریع‌ترین راه برای اتصال، از طریق نقطه‌ی انتهایی میزبانی‌شده‌ی MCP ماست — بدون بسته‌ای برای نصب و بدون راه‌اندازی محلی.

Claude.ai

به Settings → Connectors بروید
روی + کلیک کنید تا یک connector جدید اضافه کنید
این URL را وارد کنید: https://mcp.blocklens.co
Client ID و Client Secret را خالی بگذارید ← روی Add کلیک کنید
هنگام درخواست، با کلید API خود مجوز دهید

Claude Desktop

این را به claude_desktop_config.json خود اضافه کنید:

{
  "mcpServers": {
    "blocklens": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.blocklens.co"]
    }
  }
}

ChatGPT

Developer Mode را فعال کنید: Settings → General → Developer Mode
به Settings → Developer → MCP Servers بروید
روی Add Server کلیک کنید، نام "Blocklens" و این URL را وارد کنید: https://mcp.blocklens.co
هنگام درخواست، با کلید API خود مجوز دهید

Cursor / Windsurf

Settings → MCP Servers را باز کنید
یک سرور از راه دور با این URL اضافه کنید: https://mcp.blocklens.co
هنگام درخواست، با کلید API خود مجوز دهید

برای Cursor، می‌توانید آن را به .cursor/mcp.json نیز اضافه کنید:

{
  "mcpServers": {
    "blocklens": {
      "url": "https://mcp.blocklens.co"
    }
  }
}

هر کلاینت HTTP سازگار با MCP

با استفاده از انتقال Streamable HTTP به https://mcp.blocklens.co درخواست POST بفرستید. سرور از پروتکل کامل MCP پشتیبانی می‌کند — کشف ابزار، فراخوانی و پاسخ‌های استریمینگ.

بدون نیاز به نصب

نقطه‌ی انتهایی از راه دور همان ۱۹ ابزار بسته‌ی npm را ارائه می‌دهد. در مرورگر کار می‌کند، به هیچ وابستگی محلی نیاز ندارد و از حالت دمو به‌صورت آماده پشتیبانی می‌کند.

احراز هویت

سرور MCP از دو حالت دسترسی پشتیبانی می‌کند:

دسترسی رایگان (بدون کلید API)

بدون هیچ اعتبارنامه‌ای متصل شوید تا به متریک‌های سطح رایگان دسترسی داشته باشید: قیمت‌ها، عرضه‌ی هولدرها، ارزش‌گذاری، تجمیع ETF، coindays و داده‌های بلاکچین. تا ۶۰ روز تاریخچه.

دسترسی کامل (با کلید API)

تمام متریک‌ها از جمله سطوح Pro و Enterprise را باز کنید. هنگامی که برای اولین بار متصل می‌شوید، یک صفحه‌ی مجوزدهی بلاک‌لنز ظاهر می‌شود که در آن کلید API خود را وارد می‌کنید. این از یک جریان امن OAuth استفاده می‌کند — نیازی به Client ID یا Secret نیست.

کلید API خود را در blocklens.co/api-mcp دریافت کنید.

چرا بلاک‌لنز + MCP؟

بلاک‌لنز پشتیبانی بومی MCP برای تحلیل‌های on-chain ارائه می‌دهد و به عامل‌های هوش مصنوعی اجازه می‌دهد متریک‌ها را مستقیماً و بدون یکپارچه‌سازی سفارشی کوئری بزنند.

این در عمل به چه معناست:

کوئری‌های on-chain بلادرنگ — از عامل هوش مصنوعی خود بپرسید «آیا بیت‌کوین در حال حاضر بیش‌ارزش‌گذاری شده است؟» و آن get_holder_valuation را برای بررسی MVRV، realized cap و موارد دیگر فراخوانی می‌کند
بدون کار دستی با API — عامل به‌طور خودکار ابزارها را کشف می‌کند و پاسخ‌ها را برای شما قالب‌بندی می‌کند
پژوهش با سرعت گفتگو — چندین کوئری را به‌هم زنجیر کنید: قیمت را بررسی کنید، سپس عرضه، سپس سودآوری، همگی در یک گفتگو
گزارش‌دهی خودکار — به عامل خود اجازه دهید گزارش‌های هفتگی سلامت on-chain را با داده‌های زنده تولید کند

نصب محلی (جایگزین)

برای ساده‌ترین راه‌اندازی به دسترسی از راه دور مراجعه کنید — نیازی به بسته یا پیکربندی محلی نیست.

نصب

npm install -g blocklens-mcp-server

Claude Desktop

این را به فایل پیکربندی Claude Desktop خود (claude_desktop_config.json) اضافه کنید:

{
  "mcpServers": {
    "blocklens": {
      "command": "npx",
      "args": ["-y", "blocklens-mcp-server"],
      "env": {
        "BLOCKLENS_API_KEY": "your_api_key_here"
      }
    }
  }
}

محل فایل پیکربندی:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

پس از ذخیره، Claude Desktop را مجدداً راه‌اندازی کنید. باید "blocklens" را در فهرست ابزارهای MCP موجود ببینید.

Cursor / Windsurf

به تنظیمات MCP خود (.cursor/mcp.json یا معادل آن) اضافه کنید:

{
  "mcpServers": {
    "blocklens": {
      "command": "npx",
      "args": ["-y", "blocklens-mcp-server"],
      "env": {
        "BLOCKLENS_API_KEY": "your_api_key_here"
      }
    }
  }
}

حالت دمو (بدون کلید API)

می‌توانید سرور MCP را بدون کلید API امتحان کنید. در حالت دمو:

کار می‌کند: list_metrics، search_metrics، get_metric، get_categories و نقاط انتهایی داده تا ۶۰ روز تاریخچه برای متریک‌های پایه (grade 0)
نیازمند کلید API: متریک‌های سود (SOPR، realized P/L)، تاریخچه‌ی گسترده، متریک‌های سطح enterprise

برای اجرا در حالت دمو، کافی است BLOCKLENS_API_KEY را از پیکربندی خود حذف کنید:

{
  "mcpServers": {
    "blocklens": {
      "command": "npx",
      "args": ["-y", "blocklens-mcp-server"]
    }
  }
}

ابزارهای موجود

سرور MCP، ۱۹ ابزار را در دسترس قرار می‌دهد که کل مجموعه‌ی تحلیلی بلاک‌لنز را پوشش می‌دهند: داده‌های بازار، عرضه‌ی هولدرها، ارزش‌گذاری، سودآوری، کوهورت‌های سنی، تاریخچه‌ی UTXO، coin days، تحلیل‌های ETF، آمار بلاکچین، مرزهای چرخه و رندر نمودار. ساخته‌شده بر پایه‌ی یک کدبیس یکپارچه‌ی TypeScript.

الزامات سطح

سطح	ابزارها
Free	`list_metrics`، `search_metrics`، `get_metric`، `get_categories`، `get_latest_metrics`، `get_prices`، `get_holder_supply`، `get_holder_valuation`، `get_etf_data`، `get_coindays`، `get_blockchain`، `get_cycle_boundaries`
Pro	`get_holder_profit`، `get_cohort_metrics`، `get_utxo_history`
Pro	`get_dat_entity`
وابسته به متریک	`render_chart` — متریک‌های رایگان بدون کلید رندر می‌شوند؛ متریک‌های Pro/Enterprise به سطح متناظر نیاز دارند

`list_metrics`

Free

فهرست تمام متریک‌های on-chain موجود همراه با توضیحات، دسته‌بندی‌ها و الزامات سطح.

پارامترها: ندارد

کاربرد: از اینجا شروع کنید تا کشف کنید چه داده‌هایی در دسترس است. کاتالوگ کامل را همراه با شناسه‌های متریکی که برای سایر ابزارها لازم خواهید داشت بازمی‌گرداند.

نمونه‌ی پاسخ (خلاصه‌شده):

[
  {
    "id": "price",
    "name": "BTC Price",
    "category": "price",
    "unit": "USD",
    "endpoint": "prices",
    "grade": 0
  },
  {
    "id": "lth_supply",
    "name": "LTH Supply",
    "category": "supply",
    "unit": "BTC",
    "endpoint": "holder/supply",
    "grade": 0
  },
  {
    "id": "funding_binance",
    "name": "Binance Funding Rate",
    "category": "exchanges",
    "endpoint": "funding/exchange",
    "grade": 1,
    "params": { "exchange": "binance" },
    "params_schema": {
      "exchange": {
        "type": "string",
        "required": true,
        "description": "Exchange identifier",
        "values_endpoint": "/v1/funding/exchanges"
      }
    }
  }
]

متریک‌های پارامتری

برخی متریک‌ها به پارامترهای اضافی نیاز دارند (مثلاً exchange، ticker، id). فیلد params را برای مقادیر پیش‌فرض و params_schema را برای توضیحات پارامترها و نقاط انتهایی مقادیر موجود بررسی کنید.

`get_prices`

Free

قیمت‌های روزانه‌ی OHLC (open/high/low/close به USD)، market cap و حجم معاملات ۲۴ ساعته را دریافت کنید.

پارامتر	نوع	پیش‌فرض	توضیحات
`symbol`	string	`"BTC"`	نماد ارز دیجیتال
`days`	integer	`30`	تعداد نقاط داده‌ی روزانه (۱ تا ۱۰٬۰۰۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`). جایگزین `days` می‌شود.
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`). به‌طور پیش‌فرض امروز است.

کاربرد: زمینه‌ی قیمتی برای هر تحلیلی. آن را با متریک‌های ارزش‌گذاری جفت کنید تا بسنجید آیا قیمت فعلی با بنیان‌های on-chain توجیه می‌شود یا خیر.

`get_holder_supply`

Free

تفکیک عرضه‌ی LTH/STH را دریافت کنید: عرضه‌ی هولدرهای بلندمدت (Long-Term Holder، نگهداری‌شده >۱۵۵ روز)، عرضه‌ی هولدرهای کوتاه‌مدت (Short-Term Holder، نگهداری‌شده <۱۵۵ روز) و کل عرضه‌ی در گردش. همه‌ی مقادیر به BTC.

پارامتر	نوع	پیش‌فرض	توضیحات
`days`	integer	`30`	تعداد نقاط داده‌ی روزانه (۱ تا ۱۰٬۰۰۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`)
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`)

کاربرد: ردیابی انباشت و توزیع. افزایش عرضه‌ی LTH = اعتقاد / انباشت. افزایش عرضه‌ی STH = ورود پول جدید / احتمال توزیع در پیش.

`get_holder_valuation`

Free

متریک‌های ارزش‌گذاری بیت‌کوین را دریافت کنید: Realized Cap، Realized Price، Realized Cap و Price برای LTH/STH، نسبت MVRV و سود/زیان تحقق‌نیافته (Unrealized P/L).

پارامتر	نوع	پیش‌فرض	توضیحات
`days`	integer	`30`	تعداد نقاط داده‌ی روزانه (۱ تا ۱۰٬۰۰۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`)
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`)

کاربرد: چارچوب اصلی ارزش‌گذاری. از نظر تاریخی، MVRV > 3.5 نشانه‌ی داغ‌شدن بازار است؛ MVRV < 1 نشانه‌ی کم‌ارزش‌گذاری است. realized price مربوط به LTH را با STH مقایسه کنید تا ساختار بازار را بسنجید.

`get_holder_profit`

Pro

متریک‌های سودآوری بیت‌کوین را دریافت کنید: Realized P/L مربوط به LTH/STH (به USD) و SOPR (نسبت سود خروجی خرج‌شده — Spent Output Profit Ratio). نیازمند کلید API سطح Pro است.

پارامتر	نوع	پیش‌فرض	توضیحات
`days`	integer	`30`	تعداد نقاط داده‌ی روزانه (۱ تا ۱۰٬۰۰۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`)
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`)

کاربرد: درک اینکه آیا کوین‌ها با سود جابه‌جا می‌شوند یا با زیان. SOPR > 1 یعنی هولدرها با سود می‌فروشند؛ SOPR < 1 یعنی فروش با زیان (اغلب نشانه‌ی تسلیم بازار یا شکل‌گیری کف است).

`get_cohort_metrics`

Pro

متریک‌های کوهورت سنی را دریافت کنید: عرضه (BTC)، realized cap (USD) و realized price (USD) برای یک بازه‌ی سنی مشخص از UTXO. برای تحلیل HODL Waves استفاده می‌شود.

پارامتر	نوع	پیش‌فرض	توضیحات
`cohort`	enum	الزامی	بازه‌ی سنی (به پایین مراجعه کنید)
`days`	integer	`30`	تعداد نقاط داده‌ی روزانه (۱ تا ۱۰٬۰۰۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`)
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`)

کوهورت‌های معتبر: 24h، 1d_1w، 1w_1m، 1m_3m، 3m_6m، 6m_12m، 1y_2y، 2y_3y، 3y_5y، 5y_7y، 7y_10y، 10y_plus

کاربرد: بررسی عمیق گروه‌های سنی مشخص. برای مثال، بررسی کنید آیا کوهورت 3m_6m در حال رشد است (انباشت جدید در حال بلوغ) یا اینکه کوین‌های 10y_plus بالاخره در حال جابه‌جایی هستند (بیدار شدن عرضه‌ی دیرینه‌ی غیرفعال).

`get_utxo_history`

Pro

تفکیک مجموعه‌ی UTXO بر اساس کوهورت سنی را دریافت کنید. مقادیر توکن (BTC) و ارزش‌های USD را برای هر کوهورت در یک تاریخ مشخص نشان می‌دهد.

پارامتر	نوع	پیش‌فرض	توضیحات
`date_processed`	string	—	تاریخ snapshot مشخص (`YYYY-MM-DD`)
`cohort_start`	string	—	شروع بازه‌ی تاریخ کوهورت
`cohort_end`	string	—	پایان بازه‌ی تاریخ کوهورت
`days`	integer	`1000`	تعداد رکوردها (۱ تا ۵۰٬۰۰۰)

کاربرد: تحلیل الگوهای غیرفعالی (dormancy) و انباشت کوین. وقتی عرضه‌ی غیرفعال جابه‌جا می‌شود، اغلب پیش‌درآمد حرکت قیمتی قابل‌توجهی است.

`get_latest_metrics`

Free

جدیدترین snapshot را در تمام دسته‌بندی‌های متریک (قیمت، عرضه، ارزش‌گذاری، سود) در یک فراخوانی واحد دریافت کنید.

پارامترها: ندارد

کاربرد: مرور سریع بازار. یک فراخوانی وضعیت فعلی تمام متریک‌های کلیدی را به شما می‌دهد — ایده‌آل برای بررسی‌های روزانه یا شروع یک تحلیل عمیق‌تر.

`search_metrics`

Free

متریک‌های موجود را بر اساس کلیدواژه در نام‌ها، توضیحات و شناسه‌ها جستجو کنید.

پارامتر	نوع	پیش‌فرض	توضیحات
`query`	string	الزامی	عبارت جستجو (مثلاً `"realized price"`، `"MVRV"`، `"supply"`)

کاربرد: پیدا کردن متریک مناسب وقتی تقریباً می‌دانید دنبال چه چیزی هستید اما شناسه‌ی دقیق را نمی‌دانید. متریک‌های منطبق را همراه با نقاط انتهایی و الزامات سطح آن‌ها بازمی‌گرداند.

`get_metric`

Free

تعریف کامل یک متریک واحد را بر اساس شناسه‌ی آن دریافت کنید، شامل نام، توضیحات، دسته‌بندی، نقطه‌ی انتهایی، واحد و سطح دسترسی.

پارامتر	نوع	پیش‌فرض	توضیحات
`metric_id`	string	الزامی	شناسه‌ی متریک (مثلاً `"lth_supply"`، `"price"`، `"sth_sopr"`)

کاربرد: پیش از واکشی داده، دقیقاً بفهمید یک متریک چه چیزی را اندازه‌گیری می‌کند، چگونه محاسبه می‌شود و چه سطحی لازم است. پاسخ شامل params و params_schema است هنگامی که متریک به پارامترهای اضافی نیاز دارد (مثلاً exchange، ticker، id).

`get_categories`

Free

فهرست تمام دسته‌بندی‌های متریک به همراه تعداد و شناسه‌های متریک در هر دسته.

پارامترها: ندارد

کاربرد: دریافت یک نمای کلی ساختاریافته از داده‌های موجود، سازمان‌دهی‌شده بر اساس موضوع (قیمت، عرضه، ارزش‌گذاری، سود).

`get_coindays`

Free

متریک‌های Coin Days را دریافت کنید: Coin Days Destroyed (CDD)، liveliness، vaultedness و dormancy. این متریک‌ها اندازه‌گیری می‌کنند که کوین‌ها پیش از خرج‌شدن چه مدت نگهداری شده‌اند و الگوهای اعتقاد و فعالیت را آشکار می‌سازند.

پارامتر	نوع	پیش‌فرض	توضیحات
`days`	integer	`30`	تعداد نقاط داده‌ی روزانه (۱ تا ۱۰٬۰۰۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`)
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`)

کاربرد: تشخیص زمانی که کوین‌های دیرینه‌ی غیرفعال شروع به جابه‌جایی می‌کنند. جهش‌های بالای CDD اغلب پیش‌درآمد حرکات بزرگ قیمتی هستند. افزایش liveliness = خرج‌شدن کوین‌های قدیمی؛ افزایش vaultedness = قفل‌شدن کوین‌ها برای نگهداری بلندمدت.

`get_etf_data`

Free

داده‌های تجمیعی ETF بیت‌کوین را دریافت کنید: کل دارایی‌ها (BTC)، AUM (USD)، جریان‌های خالص روزانه، جریان‌های تجمعی، تسلط ETF و realized price مربوط به ETF.

پارامتر	نوع	پیش‌فرض	توضیحات
`days`	integer	`30`	تعداد نقاط داده‌ی روزانه (۱ تا ۱۰٬۰۰۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`)
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`)

کاربرد: ردیابی تقاضای نهادی از طریق جریان‌های ETF. افزایش AUM و جریان‌های خالص مثبت نشانه‌ی انباشت نهادی هستند. realized price مربوط به ETF را با قیمت اسپات مقایسه کنید تا بسنجید آیا هولدرهای ETF در سود هستند.

`get_blockchain`

Free

متریک‌های بلاکچین را دریافت کنید: ارتفاع بلاک یا تعداد بلاک‌های استخراج‌شده در روز.

پارامتر	نوع	پیش‌فرض	توضیحات
`metric`	enum	الزامی	`"block_height"` یا `"blocks_mined"`
`days`	integer	`30`	تعداد نقاط داده‌ی روزانه (۱ تا ۱۰٬۰۰۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`)
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`)

کاربرد: پایش سلامت شبکه و فعالیت استخراج. انحراف تعداد بلاک‌های استخراج‌شده در روز از حدود ۱۴۴ می‌تواند نشان‌دهنده‌ی تغییرات hashrate یا تنظیمات سختی (difficulty) باشد.

`get_dat_aggregate`

Free

داده‌های تجمیعی Digital Asset Treasuries را دریافت کنید: کل BTC نگهداری‌شده توسط نهادها و دولت‌ها، تعداد شرکت‌ها، جریان‌های خالص و تفکیک عمومی/خصوصی/دولتی.

پارامتر	نوع	پیش‌فرض	توضیحات
`days`	integer	`30`	تعداد نقاط داده‌ی روزانه (۱ تا ۱۰٬۰۰۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`)
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`)

کاربرد: ردیابی پذیرش نهادی بیت‌کوین. افزایش کل BTC در خزانه‌های شرکتی و حاکمیتی نشانه‌ی رشد اعتقاد نهادی است.

برای realized price (مبنای هزینه به ازای هر BTC) بر اساس نوع نهاد (دولتی، عمومی، خصوصی)، از render_chart با متریک‌های dat_rp_total، dat_rp_public، dat_rp_government، dat_rp_private یا قالب dat-realized-price-by-type استفاده کنید.

`get_dat_registry`

Free

فهرست تمام نهادهای ردیابی‌شده‌ی Digital Asset Treasury (شرکت‌ها، صندوق‌ها، دولت‌ها) همراه با متادیتا شامل نام، ticker، نوع نهاد و کشور.

پارامترها: ندارد

کاربرد: کشف اینکه کدام نهادها بیت‌کوین نگهداری می‌کنند. از فیلد id بازگردانده‌شده برای کوئری داده‌ی هر نهاد با get_dat_entity استفاده کنید.

`get_dat_entity`

Pro

داده‌های Digital Asset Treasury هر نهاد را دریافت کنید: دارایی BTC، AUM، جریان خالص، جریان تجمعی، سهم بازار، realized price (میانگین هزینه به ازای هر BTC) و کل مبنای هزینه.

پارامتر	نوع	پیش‌فرض	توضیحات
`id`	integer	الزامی	شناسه‌ی نهاد/شرکت (از `get_dat_registry`)
`days`	integer	`365`	تعداد نقاط داده‌ی روزانه (۱ تا ۱۰٬۰۰۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`)
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`)

کاربرد: تحلیل استراتژی بیت‌کوین یک نهاد مشخص — ردیابی رشد دارایی‌ها، مقایسه‌ی realized price با قیمت بازار برای محاسبه‌ی سود/زیان تحقق‌نیافته و پایش الگوهای انباشت.

مثال: get_dat_entity({ id: 1 }) داده‌های Strategy (که پیش‌تر MicroStrategy بود) را بازمی‌گرداند، شامل 762K BTC دارایی و realized price برابر با $75,694.

`get_cycle_boundaries`

Free

مرزهای چرخه‌ی هاوینگ بیت‌کوین را دریافت کنید: تاریخ شروع، تاریخ پایان، مدت به روز و شماره‌ی چرخه برای هر دوره‌ی هاوینگ.

پارامترها: ندارد

کاربرد: شناسایی فازهای چرخه برای تحلیل مقایسه‌ای. آن را با render_chart و x_axis: "day_offset" استفاده کنید تا نمودارهای عملکرد چرخه را روی هم بیندازید که در آن همه‌ی چرخه‌ها از روز ۰ آغاز می‌شوند.

نمونه‌ی پاسخ (خلاصه‌شده):

[
  { "cycle": 1, "start_date": "2009-01-03", "end_date": "2012-11-28", "duration_days": 1426 },
  { "cycle": 2, "start_date": "2012-11-28", "end_date": "2016-07-09", "duration_days": 1319 },
  { "cycle": 3, "start_date": "2016-07-09", "end_date": "2020-05-11", "duration_days": 1402 },
  { "cycle": 4, "start_date": "2020-05-11", "end_date": "2024-04-20", "duration_days": 1441 },
  { "cycle": 5, "start_date": "2024-04-20", "end_date": null, "duration_days": null }
]

`render_chart`

وابسته به متریک

یک نمودار تحلیلی on-chain بیت‌کوین را به‌صورت تصویر PNG یا گرافیک برداری SVG رندر کنید. تصویر را به‌صورت inline در گفتگو بازمی‌گرداند. از متریک‌های واحد، چند متریک، قالب‌ها و سفارشی‌سازی کامل پشتیبانی می‌کند.

پارامتر	نوع	پیش‌فرض	توضیحات
`metric`	string	—	شناسه‌ی متریک واحد (مثلاً `"price"`، `"lth_supply"`)
`metrics`	array	—	چند متریک به‌صورت رشته یا آبجکت‌های پیکربندی
`template`	string	—	قالب نمودار (مثلاً `"mvrv_ratio"`، `"holder_supply"`)
`days`	integer	`365`	روزهای تاریخچه (۷ تا ۳٬۶۵۰)
`start_date`	string	—	تاریخ شروع (`YYYY-MM-DD`)
`end_date`	string	—	تاریخ پایان (`YYYY-MM-DD`)
`overlay`	`"price"`	—	افزودن overlay قیمت BTC
`theme`	`"light"` / `"dark"`	`"light"`	تم رنگ
`width`	integer	`1200`	عرض تصویر به پیکسل
`height`	integer	`600`	ارتفاع تصویر به پیکسل
`title`	string	auto	عنوان نمودار
`style`	`"line"` / `"area"` / `"bar"`	auto	سبک پیش‌فرض نمودار
`scale`	`"linear"` / `"log"`	`"linear"`	مقیاس محور Y
`y_axes`	array	—	محورهای Y سفارشی با نواحی عمودی. هر آبجکت: `{ id, side, scale?, format?, range?, domain_min?, domain_max?, no_padding? }`. به Snapshot API — Custom Y-Axes مراجعه کنید.
`x_axis`	`"date"` / `"day_offset"`	`"date"`	حالت محور X. برای overlayهای عملکرد چرخه از `"day_offset"` استفاده کنید. لازم است همه‌ی `metrics` از یک خانواده‌ی `cycle_ath_`، `cycle_low_` یا `cycle_halving_*` باشند.
`heatmap_id`	`"cost-basis-distribution"`	—	به جای نمودار خطی یک heatmap رندر کنید. با `metric` / `metrics` / `template` متقابلاً انحصاری است. به Heatmap Rendering مراجعه کنید.
`heatmap_period`	`"3m"` / `"6m"` / `"1y"` / `"2y"` / `"3y"` / `"5y"` / `"all"`	`"1y"`	پنجره‌ی زمانی برای دسته‌بندی heatmap.
`heatmap_color_scale`	`"viridis"` / `"plasma"` / `"inferno"` / `"magma"` / `"cividis"`	`"viridis"`	پالت رنگ برای سلول‌های heatmap.
`heatmap_y_scale`	`"linear"` / `"log"`	`"linear"`	مقیاس محور Y برای دسته‌های قیمتی heatmap.
`params`	object	—	پارامترهای هر فراخوانی برای متریک‌های پارامتری (مثلاً `{ exchange: "binance" }`، `{ ticker: "IBIT" }`). الزامی است وقتی `params_schema` متریک یک فیلد الزامی را اعلام می‌کند.
`format`	`"png"` / `"svg"` / `"json"`	`"png"`	قالب خروجی. `"png"` یک تصویر رستری بازمی‌گرداند، `"svg"` یک گرافیک برداری مقیاس‌پذیر بازمی‌گرداند (ایده‌آل برای جاسازی در اسلایدها یا چاپ)، `"json"` فقط متادیتای نمودار را بازمی‌گرداند (بدون رندر).

کاربرد: هر متریکی را مستقیماً در گفتگو تجسم کنید. عامل یک تصویر نمودار بازمی‌گرداند که به‌صورت inline ظاهر می‌شود — نیازی به باز کردن مرورگر یا داشبورد نیست.

نمونه فراخوانی‌ها:

render_chart({ metric: "price" })
render_chart({ template: "mvrv_ratio", days: 730 })
render_chart({ metrics: ["lth_supply", "sth_supply"], style: "area", days: 730 })
render_chart({ metric: "funding_binance" })
render_chart({ metrics: [{ id: "funding_binance", params: { exchange: "binance" } }] })
render_chart({ metrics: ["cycle_ath_1","cycle_ath_2","cycle_ath_3","cycle_ath_4","cycle_ath_5"], x_axis: "day_offset", scale: "log" })
render_chart({ heatmap_id: "cost-basis-distribution", heatmap_period: "1y", theme: "dark" })
render_chart({ template: "mvrv_ratio", format: "svg" })  // vector output

برخی متریک‌ها به پارامتر نیاز دارند (مانند exchange یا ticker). هنگام استفاده از آرایه‌ی metrics با آبجکت‌های پیکربندی، params را از تعریف متریک بگنجانید.

برای مستندات کامل گزینه‌های رندر نمودار به Snapshot API مراجعه کنید.

موارد کاربرد همراه با نمونه پرامپت‌ها

در اینجا پرامپت‌های مشخصی آمده است که می‌توانید پس از اتصال سرور MCP بلاک‌لنز به عامل هوش مصنوعی خود بدهید.

تحلیل ارزش‌گذاری بازار

«آیا بیت‌کوین در حال حاضر بیش‌ارزش‌گذاری شده است؟ نسبت MVRV را بررسی کن و realized price مربوط به LTH و STH را با قیمت اسپات فعلی مقایسه کن.»

عامل get_holder_valuation و get_prices را فراخوانی می‌کند، سپس داده‌ها را ترکیب می‌کند تا بسنجد آیا ارزش بازار فعلی بالاتر یا پایین‌تر از مبنای هزینه‌ی تجمیعی است.

پژوهش HODL Waves

«به من نشان بده توزیع عرضه در میان کوهورت‌های سنی طی سال گذشته چگونه تغییر کرده است. آیا هولدرهای بلندمدت در حال انباشت هستند یا توزیع؟»

عامل get_cohort_metrics را برای چندین کوهورت با days: 365 فراخوانی می‌کند، سپس روندها در هر بازه‌ی سنی را تحلیل می‌کند تا الگوهای انباشت در برابر توزیع را شناسایی کند.

گزارش هفتگی on-chain

«یک گزارش هفتگی سلامت on-chain بیت‌کوین تولید کن که حرکت قیمت، پویایی عرضه، سودآوری هولدرها و MVRV را پوشش دهد.»

عامل get_latest_metrics را برای یک snapshot فراخوانی می‌کند، سپس برای روندهای ۷ روزه به get_prices، get_holder_supply، get_holder_valuation و get_holder_profit ورود می‌کند و یک خلاصه‌ی ساختاریافته تولید می‌کند.

شناسایی فاز چرخه

«روند realized cap درباره‌ی فاز فعلی بازار چه چیزی را نشان می‌دهد؟ نرخ رشد realized cap را با ماه‌های قبل مقایسه کن.»

عامل get_holder_valuation را با یک پنجره‌ی زمانی طولانی‌تر فراخوانی می‌کند و مسیر realized cap را تحلیل می‌کند تا شناسایی کند آیا در فاز انباشت، صعود (markup)، توزیع یا نزول (markdown) هستیم.

تشخیص تسلیم بازار

«بررسی کن آیا STH SOPR طی ۳۰ روز گذشته به زیر ۱ افتاده است — این نشان‌دهنده‌ی فروش هولدرهای کوتاه‌مدت با زیان است.»

عامل get_holder_profit را با days: 30 فراخوانی می‌کند و مقادیر STH SOPR را بررسی می‌کند تا رویدادهای تسلیم بازار را علامت‌گذاری کند.

سطوح دسترسی

سطح	دسترسی MCP	تاریخچه	متریک‌ها	درخواست‌های روزانه
Demo (بدون کلید)	بله	۶۰ روز	پایه (grade 0)	نامحدود
Pro (۵۰ دلار در ماه)	بله	نامحدود	همه (grade 0–1)	۱۰٬۰۰۰
Enterprise (۹۰۰ دلار در ماه)	بله	نامحدود	همه (grade 0–2)	۱۰۰٬۰۰۰

سرور MCP با تمام سطوح کار می‌کند. حالت دمو راهی عالی برای کاوش ابزارها پیش از اشتراک است. برای باز کردن دسترسی کامل، یک کلید API دریافت کنید.

کلید API خود را دریافت کنید

برای ایجاد کلید API و مشاهده‌ی سطح اشتراک و میزان مصرف خود، به blocklens.co/api-mcp مراجعه کنید.

منابع

نقطه‌ی انتهایی MCP از راه دور: mcp.blocklens.co
بسته‌ی npm: blocklens-mcp-server
کد منبع: GitHub
llms.txt: docs.blocklens.co/llms.txt
مانیفست پلاگین هوش مصنوعی: docs.blocklens.co/.well-known/ai-plugin.json
مستندات Snapshot API: Chart Snapshot API
مرجع API: مستندات تعاملی API
دریافت کلید API: blocklens.co/api-mcp
پروتکل MCP: modelcontextprotocol.io

MCP چیست؟​

دسترسی از راه دور (بدون نیاز به نصب)​

Claude.ai​

Claude Desktop​

ChatGPT​

Cursor / Windsurf​

هر کلاینت HTTP سازگار با MCP​

احراز هویت​

دسترسی رایگان (بدون کلید API)​

دسترسی کامل (با کلید API)​

چرا بلاک‌لنز + MCP؟​

نصب محلی (جایگزین)​

نصب​

Claude Desktop​

Cursor / Windsurf​

حالت دمو (بدون کلید API)​

ابزارهای موجود​

الزامات سطح​

list_metrics​

get_prices​

get_holder_supply​

get_holder_valuation​

get_holder_profit​

get_cohort_metrics​

get_utxo_history​

get_latest_metrics​

search_metrics​

get_metric​

get_categories​

get_coindays​

get_etf_data​

get_blockchain​

get_dat_aggregate​

get_dat_registry​

get_dat_entity​

get_cycle_boundaries​

render_chart​

موارد کاربرد همراه با نمونه پرامپت‌ها​

تحلیل ارزش‌گذاری بازار​

پژوهش HODL Waves​

گزارش هفتگی on-chain​

شناسایی فاز چرخه​

تشخیص تسلیم بازار​

سطوح دسترسی​

کلید API خود را دریافت کنید​

منابع​

MCP چیست؟

دسترسی از راه دور (بدون نیاز به نصب)

Claude.ai

Claude Desktop

ChatGPT

Cursor / Windsurf

هر کلاینت HTTP سازگار با MCP

احراز هویت

دسترسی رایگان (بدون کلید API)

دسترسی کامل (با کلید API)

چرا بلاک‌لنز + MCP؟

نصب محلی (جایگزین)

نصب

Claude Desktop

Cursor / Windsurf

حالت دمو (بدون کلید API)

ابزارهای موجود

الزامات سطح

`list_metrics`

`get_prices`

`get_holder_supply`

`get_holder_valuation`

`get_holder_profit`

`get_cohort_metrics`

`get_utxo_history`

`get_latest_metrics`

`search_metrics`

`get_metric`

`get_categories`

`get_coindays`

`get_etf_data`

`get_blockchain`

`get_dat_aggregate`

`get_dat_registry`

`get_dat_entity`

`get_cycle_boundaries`

`render_chart`

موارد کاربرد همراه با نمونه پرامپت‌ها

تحلیل ارزش‌گذاری بازار

پژوهش HODL Waves

گزارش هفتگی on-chain

شناسایی فاز چرخه

تشخیص تسلیم بازار

سطوح دسترسی

کلید API خود را دریافت کنید

منابع