# Tops Now Works With AI Agents By [Chainbase Network - Blog](https://blog.chainbase.com) · 2026-04-10 --- AI agents need more structured data they can actually use than raw feeds and scattered timelines. Tops turns crypto narratives, topic discovery, and social mentions on X into structured data that AI agents can call directly. It’s free to use, requires no API key, and now supports multiple integration paths including MCP, Skill, and API. Why Tops matters for AI agents ------------------------------ ![](https://storage.googleapis.com/papyrus_images/5aabb33c166cc62f4a27ebafae11111d59cef8c2370d4b65088056f0d116ebc9.png) Real-time crypto attention is hard to track. Narratives form on X, mentions spike quickly, and new topics can go from niche to market-wide in hours. For AI agents, this signal is difficult to use when it stays buried in noisy timelines, fragmented posts, and unstructured social chatter. Tops provides a usable layer for that problem. With Tops, AI agents can: * identify rising narratives in real time * inspect a topic through summaries, keywords, and representative posts * monitor mentions around a project or keyword * connect social heat with onchain validation Three ways to integrate Tops ---------------------------- Depending on how you build, there are three simple ways to bring Tops into your workflow. **Also, you can see Tops in action here:** [https://app.arcade.software/share/9dyyjRiVlINsqLJUesJA](https://app.arcade.software/share/9dyyjRiVlINsqLJUesJA) **This quick demo walks through how to use Tops data in an AI agent workflow.** ### 1\. MCP Server Best for AI clients and MCP-compatible tools. endpoint: [https://api.chainbase.com/tops/v1/mcp](https://api.chainbase.com/tops/v1/mcp) Add it with: claude mcp add --transport http tops This is the fastest path if you want an AI client to start querying Tops as part of its toolset. ### 2\. Claude Code Skill Best for OpenClaw and Claude Code users. Install with: npx skills add --skill web3-data Once installed, you can ask natural language questions like: > What are the hottest narratives in crypto right now? This is a simple way to make Tops feel native inside your coding workflow. ### 3\. CLI / REST API Best for teams building their own agents and custom pipelines. Resources: * CLI: [https://github.com/chainbase-labs/cli](https://github.com/chainbase-labs/cli) * API docs: [https://docs.chainbase.com/api-reference/tops-api/tool/list-trending-topics](https://docs.chainbase.com/api-reference/tops-api/tool/list-trending-topics) If you want more control over how your agent scans, ranks, filters, or combines social signals with other data sources, this path gives you the most flexibility. The 5 core tools ---------------- ![](https://storage.googleapis.com/papyrus_images/2ec8ff26b04cf07b7078154577b9d5f9a02cc5e4bf5976195f16c806aa7eae0f.png) Tops is built around a small but useful set of tools that cover the main social signal workflows agents need. Tool What it does `list_trending_topics` Returns a ranked list of current trending narratives and their heat scores. `get_topic` Returns structured details for a topic, including summary, keywords, and representative posts. `get_topic_posts` Returns the underlying posts for a topic, useful for sentiment analysis and timeline tracking. `search_narrative_candidates` Maps a fuzzy keyword to related narratives, such as “RWA” to matching topics. `search_mentions` Searches recent X mentions for a project, protocol, or keyword. Best practices for using Tops well ---------------------------------- Tops becomes much more powerful when it is part of a loop, not just a one-off query. Here are three practical ways to use it well. ### 1\. Trend scanning loop Let your agent check `list_trending_topics` on a schedule, detect new narratives, then automatically call `get_topic` to dig deeper and produce a summary or report. This is one of the cleanest ways to build a “what matters now” workflow for research agents, content agents, or internal intelligence dashboards. ### 2\. Social signal plus onchain validation Social momentum alone is not enough. The most useful agent workflows connect attention with onchain reality. A strong pattern is: 1. use Tops to find a fast-rising narrative 2. use Chainbase Web3 MCP or API to check supporting onchain signals such as token holders, volume, or transaction activity 3. let the agent compare social heat with onchain confirmation That closes the loop from narrative to validation. ### 3\. Narrative monitoring Use `search_mentions` to track a project, keyword, or sector over time. Your agent can monitor changes in attention, run basic sentiment checks, and trigger alerts when conversation shifts. This is useful for ecosystem teams, traders, and agent workflows that need to stay aware of narrative movement without manually watching X all day. What this unlocks ----------------- Tops is not just another dashboard for humans. It is a way to make crypto attention legible for machines. That matters because more and more agent workflows will depend on knowing what the market is paying attention to in real time. Not after the fact. Not through screenshots. Not through manually curated lists. Through structured signals they can actually query and act on. For AI agents in crypto, that is a meaningful upgrade. Start using Tops ---------------- If you are building agents that need to understand crypto narratives as they form, Tops is ready to plug in today. You can start with MCP, install it as a skill, or wire it into your own stack through CLI and REST API. Explore Tops and start building: * Product: [https://tops.chainbase.com/](https://tops.chainbase.com/) * MCP endpoint: [https://api.chainbase.com/tops/v1/mcp](https://api.chainbase.com/tops/v1/mcp) * Docs: [https://docs.chainbase.com/api-reference/tops-api/tool/list-trending-topics](https://docs.chainbase.com/api-reference/tops-api/tool/list-trending-topics) **About Chainbase** ------------------- Chainbase is building the Hyperdata Network for AI — a foundational layer for the DataFi era. Built as a Hyperdata Network, Chainbase turns onchain signals into structured, verifiable, and AI-ready data that can be directly processed by AI models and decentralized applications. Its core stack includes: * Manuscript: a programmable layer for building data assets; * AVS layer: decentralized data execution and verification; * $C Token: the native currency for AGI. This structured data layer supports a new generation of crypto applications that are autonomous, composable, and economically aligned with their users and contributors. To date, Chainbase has indexed over 200 blockchains, processed more than 500 billion data calls, and supports a community of more than 35,000 developers. Over 10,000 projects actively use Chainbase across a wide range of use cases, including MEV infrastructure, L2 explorers, agent protocols, and onchain analytics. The founding team brings deep experience in blockchain infrastructure, data engineering, and protocol security. Chainbase is backed by top-tier investors and works closely with ecosystems across modular infrastructure, large language models, and onchain AI. As the need for machine-readable and economically aligned data continues to grow, Chainbase provides the foundational layer for a programmable data economy—one where information moves freely between agents, protocols, and people. [**Website**](https://chainbase.com/) | [**Twitter**](https://twitter.com/ChainbaseHQ) | [**Discord**](https://discord.gg/chainbase) | [**Telegram**](https://t.me/ChainbaseNetwork) | [**Blog**](https://blog.chainbase.com/) | [**Docs**](https://docs.chainbase.com/) | [**Github**](https://github.com/chainbase-labs) ![](https://storage.googleapis.com/papyrus_images/1362b2d3124199fe569037be110aee74de3ea65132d9a304c611bd5098eeec9b.png) --- *Originally published on [Chainbase Network - Blog](https://blog.chainbase.com/tops-now-works-with-ai-agents)*