blockbeats-mcp

BlockBeats MCP Server — A crypto data gateway for AI assistants, powered by the BlockBeats Pro API.

Covers real-time newsflashes, in-depth articles, on-chain metrics, BTC ETF flows, stablecoin data, macro indicators, derivatives market data, and more.

---

Prerequisites

• Node.js 18+
• BlockBeats API Key (Apply here)

---

Installation

npm install -g blockbeats-mcp

---

Integration

Claude Desktop

Edit the config file:

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

{
  "mcpServers": {
    "blockbeats": {
      "command": "npx",
      "args": ["-y", "blockbeats-mcp"],
      "env": {
        "BLOCKBEATS_API_KEY": "your_api_key"
      }
    }
  }
}

Restart Claude Desktop to apply.

---

Cursor

Open Cursor → Settings → MCP, add:

{
  "mcpServers": {
    "blockbeats": {
      "command": "npx",
      "args": ["-y", "blockbeats-mcp"],
      "env": {
        "BLOCKBEATS_API_KEY": "your_api_key"
      }
    }
  }
}

---

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "blockbeats": {
      "command": "npx",
      "args": ["-y", "blockbeats-mcp"],
      "env": {
        "BLOCKBEATS_API_KEY": "your_api_key"
      }
    }
  }
}

---

Cline (VS Code)

Open VS Code → Cline panel → MCP Servers → Add:

{
  "blockbeats": {
    "command": "npx",
    "args": ["-y", "blockbeats-mcp"],
    "env": {
      "BLOCKBEATS_API_KEY": "your_api_key"
    }
  }
}

---

OpenClaw

Add to OpenClaw's MCP config:

{
  "mcpServers": {
    "blockbeats": {
      "command": "npx",
      "args": ["-y", "blockbeats-mcp"],
      "env": {
        "BLOCKBEATS_API_KEY": "your_api_key"
      }
    }
  }
}

---

Programmatic Usage (Node.js / TypeScript)

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "npx",
  args: ["-y", "blockbeats-mcp"],
  env: { BLOCKBEATS_API_KEY: "your_api_key" },
});

const client = new Client({ name: "my-app", version: "1.0.0" }, { capabilities: {} });
await client.connect(transport);

const result = await client.callTool({
  name: "get_newsflash",
  arguments: { category: "important", size: 10 },
});
console.log(result);

---

Available Tools

Tool	Description
get_newsflash	Newsflash list — filter by category: all / important / original / first-report / on-chain / funding / prediction / AI
get_newsflash_24h	All newsflashes from the past 24 hours (no pagination)
get_articles	Article list — filter by type: all / important / original
get_articles_24h	Articles from the past 24 hours (fixed 50 items, no pagination)
search_news	Full-text keyword search across news and articles, with pagination
get_btc_etf_flow	BTC spot ETF daily net inflow data
get_ibit_fbtc_flow	IBIT / FBTC individual fund net inflow
get_daily_onchain_tx	Daily on-chain transaction volume
get_stablecoin_marketcap	Total stablecoin market cap
get_compliant_exchange_total	Aggregated assets across compliant exchanges
get_us_treasury_yield	US Treasury yield curve data
get_dxy_index	US Dollar Index (DXY)
get_m2_supply	Global M2 money supply
get_bitfinex_long_positions	Bitfinex BTC long position data
get_contract_oi_data	Open interest by derivatives platform
get_sentiment_indicator	Market buy/sell sentiment indicator
get_top10_netflow	Top 10 tokens by on-chain net inflow
get_exchange_rankings	Derivatives exchange ranking by volume

---

Example Prompts

Once connected, ask naturally:

How much did BTC ETF inflow today?
What are the latest important crypto newsflashes?
Search for Solana-related news this week.
Is the current macro environment favorable for entering the market?
Which tokens are seeing the largest on-chain inflows?
What is the current market sentiment — bullish or bearish?

---

License

MIT