bn-square

MCP skill exposing Binance Square sentiment, hot posts, and token trending as callable tools. Works with any stdio-compatible MCP client (Claude Code, Kimi Code, Codex, Cline, Continue, etc.).

Six tools, one bearer token.

Tools

| Name | Points | Returns | |------|-------:|---------| | square_post_by_id | 1 | One post with author, metrics, sentiment | | square_search | 3 | Posts matching keyword / cashtag / author / date range | | square_hot_posts | 3 | Top posts by engagement in a time window | | sentiment_by_token | 3 | Latest aggregated sentiment bucket for a coin | | sentiment_timeseries | 5 | Historical sentiment series (chart-ready) | | token_trending | 10 | Ranked tokens by mindshare / sentiment / velocity |

Points come out of your monthly or topup balance — see main project docs for tiers.

Install

Get a bearer token (format cs_live_...) from your CryptoSquare account, then add the skill to your MCP client.

One-liner (if your client has a skills CLI)

npx skills add binance-square

Manual — any MCP client

Point your client at the package via npx with the token in env. Examples:

JSON-config clients (~/.claude.json, ~/.cline/mcp_settings.json, VS Code MCP, etc.):

{
  "mcpServers": {
    "bn-square": {
      "command": "npx",
      "args": ["-y", "bn-square"],
      "env": { "BN_SQUARE_API_TOKEN": "cs_live_YOURTOKEN" }
    }
  }
}

TOML-config clients (~/.codex/config.toml):

[mcp_servers.bn-square]
command = "npx"
args    = ["-y", "bn-square"]
env     = { BN_SQUARE_API_TOKEN = "cs_live_YOURTOKEN" }

Claude Code CLI:

claude mcp add bn-square \
  -e BN_SQUARE_API_TOKEN=cs_live_YOURTOKEN \
  -- npx -y bn-square

Restart the client and the 6 tools appear.

Try it

After install, prompt:

• "Show me the top 5 trending coins on Binance Square by mindshare"
• "What's the current sentiment for SOL on Binance Square?"
• "Find bullish BTC posts from the last 6 hours"
• "查 ETH 最近 24 小时在币安广场的情绪时序"

The LLM picks the right tool from the description.

Environment

| Var | Required | Default | |-----|----------|---------| | BN_SQUARE_API_TOKEN | yes | — | | BN_SQUARE_API_URL | no | prod CryptoSquare Worker URL | | HTTPS_PROXY / HTTP_PROXY | no | honoured via undici when set |

License

MIT