שרת MCP לסוכני AI

Blocklens מספקת שרת MCP המאפשר לסוכני AI לתשאל אנליטיקת on-chain ישירות במהלך שיחות. במקום להעתיק ולהדביק תגובות API, הסוכן שלך מגלה את הכלים הזמינים וקורא להם באופן אוטונומי.

מה זה MCP?

Model Context Protocol (MCP) הוא תקן פתוח שנוצר על ידי Anthropic, המגדיר כיצד יישומי AI מתחברים למקורות נתונים וכלים חיצוניים. אפשר לחשוב עליו כמתאם אוניברסלי — כל סוכן תואם-MCP‏ (Claude, Cursor, Windsurf וכו') יכול להתחבר לכל שרת MCP ללא קוד אינטגרציה ייעודי.

עם MCP, הסוכן לא רק קורא נתונים — הוא יכול לגלות אילו כלים זמינים, להבין את הפרמטרים שלהם, ולקרוא להם עם הארגומנטים הנכונים. זה הופך את האינטראקציות לטבעיות בהרבה בהשוואה לבניית קריאות API ידנית.

גישה מרחוק (ללא צורך בהתקנה)

הדרך המהירה ביותר להתחבר היא דרך נקודת הקצה המאוחסנת של MCP שלנו — אין חבילות להתקין, אין הגדרה מקומית.

Claude.ai

עבור אל Settings → Connectors
לחץ על + כדי להוסיף מחבר חדש
הדבק את ה-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

שלח POST אל https://mcp.blocklens.co באמצעות תעבורת Streamable HTTP. השרת תומך בפרוטוקול MCP המלא — גילוי כלים, הפעלה, ותגובות בזרימה (streaming).

אין צורך בהתקנה

נקודת הקצה המרוחקת מספקת את אותם 19 כלים כמו חבילת npm. היא פועלת בדפדפן, אינה דורשת תלויות מקומיות, ותומכת במצב הדגמה (demo) מהקופסה.

אימות

שרת MCP תומך בשני מצבי גישה:

גישה חופשית (ללא מפתח API)

התחבר ללא שום אישורים כדי לגשת למדדים בדרגה חופשית: מחירים, היצע מחזיקים (holder supply), הערכת שווי (valuation), צבירת ETF, coindays, ונתוני blockchain. עד 60 ימי היסטוריה.

גישה מלאה (עם מפתח API)

פתח את כל המדדים, כולל דרגות Pro ו-Enterprise. כשתתחבר בפעם הראשונה, תופיע עמוד הרשאה של Blocklens שבו תזין את מפתח ה-API שלך. זה משתמש בזרימת OAuth מאובטחת — אין צורך ב-Client ID או Secret.

קבל את מפתח ה-API שלך ב-blocklens.co/api-mcp.

למה Blocklens + MCP?

Blocklens מספקת תמיכת MCP מקורית עבור אנליטיקת on-chain, ומאפשרת לסוכני AI לתשאל מדדים ישירות ללא אינטגרציה ייעודית.

מה זה אומר בפועל:

תשאולי on-chain בזמן אמת — שאל את סוכן ה-AI שלך "האם Bitcoin מוערך יתר על המידה כרגע?" והוא יקרא ל-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, ונקודות קצה של נתונים עם עד 60 ימי היסטוריה עבור מדדים בסיסיים (דרגה 0)
דורש מפתח API: מדדי רווח (SOPR,‏ realized P/L), היסטוריה מורחבת, מדדים בדרגת enterprise

כדי לרוץ במצב הדגמה, פשוט השמט את BLOCKLENS_API_KEY מהתצורה שלך:

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

כלים זמינים

שרת MCP חושף 19 כלים המכסים את כל חבילת האנליטיקה של Blocklens: נתוני שוק, היצע מחזיקים, הערכת שווי, רווחיות, קבוצות גיל (cohorts), היסטוריית UTXO,‏ coin days, אנליטיקת ETF, סטטיסטיקת blockchain, גבולות מחזור (cycle boundaries), ועיבוד גרפים. בנוי על בסיס קוד 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 יומיים (פתיחה/גבוה/נמוך/סגירה ב-USD), שווי שוק (market cap), ונפח מסחר ל-24 שעות.

פרמטר	סוג	ברירת מחדל	תיאור
`symbol`	string	`"BTC"`	סמל מטבע קריפטוגרפי
`days`	integer	`30`	מספר נקודות נתונים יומיות (1–10,000)
`start_date`	string	—	תאריך התחלה (`YYYY-MM-DD`). דורס את `days`.
`end_date`	string	—	תאריך סיום (`YYYY-MM-DD`). ברירת מחדל היום.

מקרה שימוש: הקשר מחיר עבור כל ניתוח. שלב עם מדדי הערכת שווי כדי להעריך אם המחיר הנוכחי מוצדק על ידי יסודות on-chain.

`get_holder_supply`

Free

קבל את פירוק היצע LTH/STH: היצע מחזיקים לטווח ארוך (Long-Term Holder, מוחזק >155 ימים), היצע מחזיקים לטווח קצר (Short-Term Holder, מוחזק <155 ימים), וההיצע המחזורי הכולל. כל הערכים ב-BTC.

פרמטר	סוג	ברירת מחדל	תיאור
`days`	integer	`30`	מספר נקודות נתונים יומיות (1–10,000)
`start_date`	string	—	תאריך התחלה (`YYYY-MM-DD`)
`end_date`	string	—	תאריך סיום (`YYYY-MM-DD`)

מקרה שימוש: עקוב אחר צבירה והפצה. עליית היצע LTH = שכנוע / צבירה. עליית היצע STH = כסף חדש שנכנס / פוטנציאל להפצה לפנים.

`get_holder_valuation`

Free

קבל מדדי הערכת שווי של Bitcoin:‏ Realized Cap,‏ Realized Price,‏ LTH/STH Realized Cap ו-Price, יחס MVRV, ורווח/הפסד לא ממומש (Unrealized P/L).

פרמטר	סוג	ברירת מחדל	תיאור
`days`	integer	`30`	מספר נקודות נתונים יומיות (1–10,000)
`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

קבל מדדי רווחיות של Bitcoin:‏ LTH/STH Realized P/L‏ (USD) ו-SOPR‏ (Spent Output Profit Ratio). דורש מפתח API בדרגת Pro.

פרמטר	סוג	ברירת מחדל	תיאור
`days`	integer	`30`	מספר נקודות נתונים יומיות (1–10,000)
`start_date`	string	—	תאריך התחלה (`YYYY-MM-DD`)
`end_date`	string	—	תאריך סיום (`YYYY-MM-DD`)

מקרה שימוש: הבן אם מטבעות נעים ברווח או בהפסד. SOPR‏ > 1 פירושו שמחזיקים מוכרים ברווח; SOPR‏ < 1 פירושו מכירה בהפסד (לעיתים קרובות מסמן כניעה (capitulation) או היווצרות תחתית).

`get_cohort_metrics`

Pro

קבל מדדי קבוצות גיל (cohort): היצע (BTC),‏ realized cap‏ (USD), ו-realized price‏ (USD) עבור טווח גיל UTXO ספציפי. משמש לניתוח HODL Waves.

פרמטר	סוג	ברירת מחדל	תיאור
`cohort`	enum	נדרש	טווח גיל (ראה למטה)
`days`	integer	`30`	מספר נקודות נתונים יומיות (1–10,000)
`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`	מספר רשומות (1–50,000)

מקרה שימוש: נתח דפוסי רדמות (dormancy) וצבירה של מטבעות. כאשר היצע רדום נע, זה לעיתים קרובות מקדים תנועת מחיר משמעותית.

`get_latest_metrics`

Free

קבל את תצלום המצב האחרון על פני כל קטגוריות המדדים (מחיר, היצע, הערכת שווי, רווח) בקריאה אחת.

פרמטרים: אין

מקרה שימוש: סקירת שוק מהירה. קריאה אחת נותנת לך את המצב הנוכחי של כל המדדים המרכזיים — אידיאלי לבדיקות יומיות או לתחילת ניתוח עמוק יותר.

`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`	מספר נקודות נתונים יומיות (1–10,000)
`start_date`	string	—	תאריך התחלה (`YYYY-MM-DD`)
`end_date`	string	—	תאריך סיום (`YYYY-MM-DD`)

מקרה שימוש: זהה מתי מטבעות רדומים זמן רב מתחילים לנוע. זינוקי CDD גבוהים לעיתים קרובות מקדימים תנועות מחיר משמעותיות. עליית חיוניות = מטבעות ישנים מוצאים; עליית כספאות = מטבעות ננעלים להחזקה לטווח ארוך.

`get_etf_data`

Free

קבל נתוני צבירה של Bitcoin ETF: סך החזקות (BTC),‏ AUM‏ (USD), זרימות נטו יומיות, זרימות מצטברות, דומיננטיות ETF, ו-realized price של ETF.

פרמטר	סוג	ברירת מחדל	תיאור
`days`	integer	`30`	מספר נקודות נתונים יומיות (1–10,000)
`start_date`	string	—	תאריך התחלה (`YYYY-MM-DD`)
`end_date`	string	—	תאריך סיום (`YYYY-MM-DD`)

מקרה שימוש: עקוב אחר ביקוש מוסדי דרך זרימות ETF. עליית AUM וזרימות נטו חיוביות מסמנות צבירה מוסדית. השווה את ה-realized price של ETF למחיר הספוט כדי לאמוד אם מחזיקי ETF נמצאים ברווח.

`get_blockchain`

Free

קבל מדדי blockchain: גובה בלוק או בלוקים שנכרו ביום.

פרמטר	סוג	ברירת מחדל	תיאור
`metric`	enum	נדרש	`"block_height"` או `"blocks_mined"`
`days`	integer	`30`	מספר נקודות נתונים יומיות (1–10,000)
`start_date`	string	—	תאריך התחלה (`YYYY-MM-DD`)
`end_date`	string	—	תאריך סיום (`YYYY-MM-DD`)

מקרה שימוש: נטר את בריאות הרשת ופעילות הכרייה. בלוקים שנכרו ביום החורגים מ-~144 יכולים להצביע על שינויים ב-hashrate או התאמות קושי.

`get_dat_aggregate`

Free

קבל נתוני צבירה של Digital Asset Treasuries: סך ה-BTC המוחזק על ידי מוסדות וממשלות, מספר חברות, זרימות נטו, ופירוק ציבורי/פרטי/ממשלתי.

פרמטר	סוג	ברירת מחדל	תיאור
`days`	integer	`30`	מספר נקודות נתונים יומיות (1–10,000)
`start_date`	string	—	תאריך התחלה (`YYYY-MM-DD`)
`end_date`	string	—	תאריך סיום (`YYYY-MM-DD`)

מקרה שימוש: עקוב אחר אימוץ מוסדי של Bitcoin. עליית סך ה-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, סוג ישות, ומדינה.

פרמטרים: אין

מקרה שימוש: גלה אילו ישויות מחזיקות Bitcoin. השתמש בשדה id המוחזר כדי לתשאל נתונים לכל ישות עם get_dat_entity.

`get_dat_entity`

Pro

קבל נתוני Digital Asset Treasury לכל ישות: החזקות BTC,‏ AUM, זרימה נטו, זרימה מצטברת, נתח שוק, realized price (עלות ממוצעת לכל BTC), ובסיס עלות כולל.

פרמטר	סוג	ברירת מחדל	תיאור
`id`	integer	נדרש	מזהה ישות/חברה (מתוך `get_dat_registry`)
`days`	integer	`365`	מספר נקודות נתונים יומיות (1–10,000)
`start_date`	string	—	תאריך התחלה (`YYYY-MM-DD`)
`end_date`	string	—	תאריך סיום (`YYYY-MM-DD`)

מקרה שימוש: נתח את אסטרטגיית ה-Bitcoin של ישות ספציפית — עקוב אחר צמיחת החזקות, השווה realized price למחיר השוק עבור רווח/הפסד לא ממומש, ונטר דפוסי צבירה.

**דוגמה:**‏ get_dat_entity({ id: 1 }) מחזיר נתוני Strategy (לשעבר MicroStrategy) כולל 762K החזקות BTC ו-realized price של ‎$75,694.

`get_cycle_boundaries`

Free

קבל את גבולות מחזור ההיחצות (halving) של Bitcoin: תאריך התחלה, תאריך סיום, משך בימים, ומספר מחזור עבור כל תקופת היחצות.

פרמטרים: אין

מקרה שימוש: זהה שלבי מחזור לניתוח השוואתי. השתמש עם render_chart ו-x_axis: "day_offset" כדי לשכב גרפי ביצועי מחזור שבהם כל המחזורים מתחילים ביום 0.

תגובה לדוגמה (מקוצרת):

[
  { "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 של Bitcoin כתמונת PNG או כגרפיקה וקטורית SVG. מחזיר את התמונה בתוך השיחה. תומך במדדים בודדים, מספר מדדים, תבניות, והתאמה אישית מלאה.

פרמטר	סוג	ברירת מחדל	תיאור
`metric`	string	—	מזהה מדד בודד (למשל, `"price"`,‏ `"lth_supply"`)
`metrics`	array	—	מספר מדדים כמחרוזות או אובייקטי תצורה
`template`	string	—	תבנית גרף (למשל, `"mvrv_ratio"`,‏ `"holder_supply"`)
`days`	integer	`365`	ימי היסטוריה (7–3,650)
`start_date`	string	—	תאריך התחלה (`YYYY-MM-DD`)
`end_date`	string	—	תאריך סיום (`YYYY-MM-DD`)
`overlay`	`"price"`	—	הוסף שכבת-על של מחיר BTC
`theme`	`"light"` / `"dark"`	`"light"`	ערכת צבעים
`width`	integer	`1200`	רוחב תמונה בפיקסלים
`height`	integer	`600`	גובה תמונה בפיקסלים
`title`	string	אוטומטי	כותרת גרף
`style`	`"line"` / `"area"` / `"bar"`	אוטומטי	סגנון גרף ברירת מחדל
`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. השתמש ב-`"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"` מחזיר מטא-נתוני גרף בלבד (ללא עיבוד).

מקרה שימוש: המחש כל מדד ישירות בשיחה. הסוכן מחזיר תמונת גרף המופיעה בתוך השיחה — אין צורך לפתוח דפדפן או dashboard.

קריאות לדוגמה:

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 לתיעוד מלא על אפשרויות עיבוד גרפים.

מקרי שימוש עם הנחיות לדוגמה

הנה הנחיות מוחשיות שתוכל לתת לסוכן ה-AI שלך לאחר ששרת MCP של Blocklens מחובר.

ניתוח הערכת שווי שוק

"האם Bitcoin מוערך יתר על המידה כרגע? בדוק את יחס MVRV והשווה את ה-realized prices של LTH ו-STH למחיר הספוט הנוכחי."

הסוכן יקרא ל-get_holder_valuation ו-get_prices, ואז יסנתז את הנתונים כדי להעריך אם ערך השוק הנוכחי מעל או מתחת לבסיס העלות המצרפי.

מחקר HODL Waves

"הראה לי כיצד התפלגות ההיצע על פני קבוצות גיל השתנתה במהלך השנה האחרונה. האם מחזיקים לטווח ארוך צוברים או מפיצים?"

הסוכן יקרא ל-get_cohort_metrics עבור מספר קבוצות עם days: 365, ואז ינתח מגמות בכל טווח גיל כדי לזהות דפוסי צבירה מול הפצה.

דוח on-chain שבועי

"צור דוח שבועי על בריאות ה-on-chain של Bitcoin המכסה תנועת מחיר, דינמיקת היצע, רווחיות מחזיקים, ו-MVRV."

הסוכן יקרא ל-get_latest_metrics לקבלת תצלום מצב, ואז יצלול לתוך get_prices,‏ get_holder_supply,‏ get_holder_valuation, ו-get_holder_profit עבור מגמות של 7 ימים, ויפיק סיכום מובנה.

זיהוי שלב מחזור

"מה מגמת ה-realized cap מרמזת על שלב השוק הנוכחי? השווה את קצב צמיחת ה-realized cap לחודשים קודמים."

הסוכן יקרא ל-get_holder_valuation עם חלון זמן ארוך יותר וינתח את מסלול ה-realized cap כדי לזהות אם אנו נמצאים בצבירה, בעלייה (markup), בהפצה, או בירידה (markdown).

זיהוי כניעה (Capitulation)

"בדוק אם STH SOPR ירד מתחת ל-1 ב-30 הימים האחרונים — זה מצביע על מחזיקים לטווח קצר שמוכרים בהפסד."

הסוכן יקרא ל-get_holder_profit עם days: 30 ויבחן את ערכי ה-STH SOPR כדי לסמן אירועי כניעה.

דרגות גישה

דרגה	גישת MCP	היסטוריה	מדדים	בקשות יומיות
Demo (ללא מפתח)	כן	60 ימים	בסיסי (דרגה 0)	ללא הגבלה
Pro (‎$50/חודש)	כן	ללא הגבלה	הכול (דרגה 0–1)	10,000
Enterprise (‎$900/חודש)	כן	ללא הגבלה	הכול (דרגה 0–2)	100,000

שרת MCP עובד עם כל הדרגות. מצב הדגמה הוא דרך מצוינת לחקור את הכלים לפני הרשמה. קבל מפתח API כדי לפתוח גישה מלאה.

קבל את מפתח ה-API שלך

בקר ב-blocklens.co/api-mcp כדי ליצור מפתח API ולצפות בדרגת המנוי והשימוש שלך.

משאבים

נקודת קצה מרוחקת של MCP: mcp.blocklens.co
חבילת npm: blocklens-mcp-server
קוד מקור: GitHub
llms.txt: docs.blocklens.co/llms.txt
מניפסט תוסף AI: 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)​

למה Blocklens + 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 שבועי​

זיהוי שלב מחזור​

זיהוי כניעה (Capitulation)​

דרגות גישה​

קבל את מפתח ה-API שלך​

משאבים​

מה זה MCP?

גישה מרחוק (ללא צורך בהתקנה)

Claude.ai

Claude Desktop

ChatGPT

Cursor / Windsurf

כל לקוח HTTP של MCP

אימות

גישה חופשית (ללא מפתח API)

גישה מלאה (עם מפתח API)

למה Blocklens + 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 שבועי

זיהוי שלב מחזור

זיהוי כניעה (Capitulation)

דרגות גישה

קבל את מפתח ה-API שלך

משאבים