Skip to main content

​
Overview

The Tops Data MCP Server exposes Chainbase’s Tops social signal data as standardized MCP Tools, making it accessible to any MCP-compatible AI client — Claude Desktop, Cursor, Windsurf, and others. Unlike the Chainbase Web3 MCP Server (which covers on-chain data), Tops Data MCP focuses exclusively on crypto social intelligence: trending narratives, topic discovery, and Twitter/X social mentions. No API key required — it’s free to use.

​
Endpoint

https://api.chainbase.com/tops/v1/mcp
Authentication: None required. Free to call.

​
Transport

Tops Data MCP uses standard HTTP transport.
  • Content-Type: application/json
  • Method: POST
Example raw request: 
curl https://api.chainbase.com/tops/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc":"2.0", "id":1, "method":"tools/list" }'

​
Setup

​
Claude Code

claude mcp add --transport http tops https://api.chainbase.com/tops/v1/mcp

​
Claude Desktop

Settings → Connectors → Add custom connector Then enter the name: Chainbase Tops Data and Endpoint: https://api.chainbase.com/tops/v1/mcp

​
Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project): 
{
  "mcpServers": {
    "tops": {
      "url": "https://api.chainbase.com/tops/v1/mcp"
    }
  }
}

​
Other Clients

Configure your MCP client to connect to https://api.chainbase.com/tops/v1/mcp. No authentication header is needed.

​
Available Tools

ToolDescription
list_trending_topicsReturns a ranked list of currently trending crypto narratives/topics with heat scores
get_topicFetches structured details (description, keywords, representative posts) for a single topic
get_topic_postsReturns raw posts under a topic for sentiment analysis and timeline building
search_narrative_candidatesReverse-maps a keyword to candidate topics in the Tops taxonomy
search_mentionsSearches recent Twitter/X posts mentioning a keyword
For command-line usage and detailed parameter documentation, see the CLI Reference and Web3 Data Skill.

​
Rate Limits

WindowLimit
Per second10 requests
Per minute60 requests
Per hour600 requests

​
Usage Examples

Once connected, use natural language in your AI client: What are the top trending crypto narratives right now? Find all topics related to “AI Agent” and summarize the key themes. Show me what people on Twitter are saying about Chainbase. Which narratives have been heating up over the past week?

​
Difference from Chainbase Web3 MCP

Tops Data MCPChainbase Web3 MCP
Data sourceTwitter/X social signalsOn-chain blockchain data
Auth requiredNone (free)API key (X-API-KEY)
Endpointhttps://api.chainbase.com/tops/v1/mcphttps://api.chainbase.com/v1/mcp
Best forNarrative discovery, sentiment, social trendsToken data, wallet analysis, NFTs, transactions

​
Stay Updated