Tops Data MCP

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

Tool	Description
`list_trending_topics`	Returns a ranked list of currently trending crypto narratives/topics with heat scores
`get_topic`	Fetches structured details (description, keywords, representative posts) for a single topic
`get_topic_posts`	Returns raw posts under a topic for sentiment analysis and timeline building
`search_narrative_candidates`	Reverse-maps a keyword to candidate topics in the Tops taxonomy
`search_mentions`	Searches 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

Window	Limit
Per second	10 requests
Per minute	60 requests
Per hour	600 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 MCP	Chainbase Web3 MCP
Data source	Twitter/X social signals	On-chain blockchain data
Auth required	None (free)	API key (`X-API-KEY`)
Endpoint	`https://api.chainbase.com/tops/v1/mcp`	`https://api.chainbase.com/v1/mcp`
Best for	Narrative discovery, sentiment, social trends	Token data, wallet analysis, NFTs, transactions

Stay Updated

Follow Chainbase on X for release announcements
Join the Chainbase Discord community
Star the GitHub repo to get notified

Developer Resources

Chainbase AI

Data Platform

Manuscript

CLI

Overview

Endpoint

Transport

Setup

Claude Code

Claude Desktop

Cursor

Other Clients

Available Tools

Rate Limits

Usage Examples

Difference from Chainbase Web3 MCP

Stay Updated

​Overview

​Endpoint

​Transport

​Setup

​Claude Code

​Claude Desktop

​Cursor

​Other Clients

​Available Tools

​Rate Limits

​Usage Examples

​Difference from Chainbase Web3 MCP

​Stay Updated

Overview

Endpoint

Transport

Setup

Claude Code

Claude Desktop

Cursor

Other Clients

Available Tools

Rate Limits

Usage Examples

Difference from Chainbase Web3 MCP

Stay Updated