> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tops Data MCP

> Connect Tops crypto social data to any MCP-compatible AI client

## Overview

The Tops Data MCP Server exposes Chainbase's [Tops](https://tops.chainbase.com) 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](/resources/ai/cli#tops--crypto-social-intelligence) and [Web3 Data Skill](/resources/ai/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](https://twitter.com/chainbaseHQ) for release announcements
* Join the [Chainbase Discord](https://chainbase.com/discord) community
* Star the [GitHub repo](https://github.com/chainbase-labs) to get notified