# TokenTerminal MCP for AI Agents AI Agent Connect > TokenTerminal (Crypto Financial Data) lets you pull real-time revenue, TVL, and active user metrics for crypto projects. It connects your AI agent to institutional-grade data so you can do deep financial analysis on blockchains and dApps without switching tabs. Stop guessing about project health and start using the same data that big investors rely on to spot trends and growth. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_UK80EfkoKCDndu1BdY6oX3hzhHryikMFP1VouV0K/ai-agent-connect - **Tags:** crypto-analytics, financial-data, on-chain-metrics, revenue-tracking, web3-investing ## Description TokenTerminal lets you pull real-time revenue, TVL, and active user metrics for crypto projects. Most people just look at the price, but that's only half the story. This Connector gives your AI agent a direct line to the numbers that actually matter for making informed decisions. Instead of hunting through messy dashboards or trying to make sense of raw on-chain data, you can just ask your agent to compare how two different DeFi protocols are growing or check the historical performance of a specific dApp. It's like giving your AI a seat at the table where the big money moves. You'll find it's way easier to spot trends when the data is already organized and ready for analysis. You can pull this into your workflow through Vinkius to see how projects are performing in real-time. Whether you're looking for the next big L1 or just want to see how much a specific stablecoin is actually moving, this is the shortcut to getting the facts. It removes the friction of manual data collection, letting you spend your time on strategy instead of copy-pasting numbers from multiple websites. You get a clear, high-level view of the market health without the headache of digging through complex explorers. It's the difference between guessing based on hype and knowing based on actual protocol usage. ## Tools ### get_market_metrics This tool pulls aggregated market data for the entire crypto sector. Use it to see how different categories like DeFi or L1s are performing. ### get_project_metrics This tool fetches historical time-series metrics like revenue and TVL for a specific project. It provides the core data for deep financial analysis. ### get_project This tool grabs detailed metadata for a specific project. It provides context like descriptions and social links for the dApps you're researching. ### list_projects This tool lists every crypto project currently tracked by Token Terminal. It helps you see the full scope of available dApps and blockchains. ## Prompt Examples **Prompt:** ``` Which protocols are leading in revenue right now? ``` **Response:** ``` I've analyzed the current revenue metrics for the top tracked protocols. Here's a summary of the leaders: | Protocol | Revenue (24h) | TVL | Active Users | | :--- | :--- | :--- | :--- | | **Uniswap** | $12M | $5.2B | 45k | | **Aave** | $8.5M | $12B | 32k | | **Curve** | $4.2M | $3.1B | 12k | Would you like a deeper breakdown of any of these? ``` **Prompt:** ``` Compare the TVL growth of Aave and Compound. ``` **Response:** ``` Comparing the Total Value Locked (TVL) for both protocols over the last 30 days: * **Aave:** Has seen a steady increase, growing by 12% to reach a current TVL of $12B. * **Compound:** Has remained relatively flat, with a slight 2% decrease in the same period. **Summary:** Aave is currently showing stronger capital inflow compared to Compound. ``` **Prompt:** ``` What's the current market state for the DeFi sector? ``` **Response:** ``` The DeFi sector is currently showing the following aggregated metrics: * **Total Sector Revenue:** Trending up by 5% this week. * **Active User Count:** Stable across major L1s. * **Top Performing Categories:** Lending and DEXs are leading the growth. I can pull specific growth rates for any of these categories if you'd like. ``` ## Capabilities ### List all crypto projects This tool lists every crypto project currently tracked by Token Terminal. ### Fetch detailed metadata This tool grabs specific descriptions, categories, and social links for dApps. ### Pull historical revenue data This tool fetches historical time-series metrics like revenue and TVL for a project. ### Get aggregated market metrics This tool pulls aggregated market data metrics for the entire crypto sector. ### Track active user growth This tool tracks daily active users to show growth trends for specific protocols. ## Use Cases ### Comparing DeFi protocol growth An analyst asks for a comparison of Aave and Compound. The agent uses get_project_metrics to pull historical TVL and revenue for both. ### Identifying L1 leaders A user wants to know which blockchains are leading. The agent uses list_projects to see all tracked assets and filters for Layer 1s. ### Monitoring sector trends An investor wants to know the state of the DeFi market. The agent uses get_market_metrics to pull aggregated data for the whole sector. ### Researching specific dApps A developer needs context on a project. The agent uses get_project to pull descriptions and social links for a specific dApp. ## Benefits - Stop manual tab switching by using get_project_metrics to pull revenue data directly into your chat. - Spot market trends faster with get_market_metrics providing aggregated data for entire sectors. - Get context-rich project info using get_project to see social links and categories instantly. - Build data-driven reports by pulling historical time-series data for any tracked dApp. - Identify market leaders quickly by using list_projects to see the full scope of tracked assets. ## How It Works The bottom line is you get institutional-grade crypto data inside your chat interface. 1. Subscribe to the TokenTerminal MCP on Vinkius. 2. Add your Token Terminal API key to the configuration. 3. Ask your AI client to pull project metrics or market trends. ## Frequently Asked Questions **What kind of crypto data does TokenTerminal provide?** TokenTerminal gives you access to institutional-grade financial metrics like revenue, TVL, and active users for various dApps and blockchains. This helps you see the underlying health of a project rather than just its price. **Can I use TokenTerminal to track project revenue?** Yes, you can use it to pull historical revenue data for specific projects. This makes it easy to see how a protocol's income has changed over time. **How does TokenTerminal help with Web3 investing?** It helps by providing hard numbers on project growth and market trends. You can compare different protocols side-by-side to see which ones are actually gaining traction. **Does TokenTerminal work with my current AI client?** Yes, it works with any MCP-compatible client like Claude or Cursor. You just connect it through Vinkius and start asking questions. **What is the difference between price and TokenTerminal data?** Price is what people are paying right now, but TokenTerminal shows you the fundamentals. It provides data on how much money is actually moving through a protocol and how many people are using it. **Can I see historical metrics with TokenTerminal?** Yes, the Connector can pull historical time-series data for projects. This allows your agent to show you growth trends over weeks or months. **Can I get historical revenue for a specific protocol like Uniswap?** Yes! Use the `get_project_metrics` tool with 'uniswap' as the project ID and specify 'revenue' in the metrics parameter to see historical financial performance. **How do I see which blockchains are currently tracked by the platform?** Simply use the `list_projects` tool. It returns a comprehensive list of all blockchains and decentralized applications currently monitored by Token Terminal. **Is it possible to get a project's social links and category description?** Yes, the `get_project` tool provides detailed metadata including the project's description, category, and official social media links.