# TokenTerminal MCP > TokenTerminal (Crypto Financial Data) gives your AI agent access to institutional-grade crypto data. It lets you query specific project metrics—like Total Value Locked (TVL), revenue, and active users—and analyze aggregated market trends across DeFi protocols. Use it to track fundamental performance for deep analysis. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** crypto-analytics, financial-data, on-chain-metrics, revenue-tracking, web3-investing ## Description Listen up. When you hook your agent into TokenTerminal, you're giving it access to institutional-grade crypto data—the kind professional investors actually use when they wanna deep-dive on an asset or a whole sector. You don't need fluff; you need facts. *get_market_metrics* lets your agent pull together aggregated metrics for the total crypto market sector. This means you can get a real read on current performance and overall trends across the entire digital finance space, not just one corner of it. It gives you the big picture view, so you know which way the whole ship is sailing. To figure out what's actually running in this space, use *list_projects*. This tool spits out a comprehensive list of every single blockchain and dApp that TokenTerminal keeps track of. You can see the sheer breadth of projects monitored, which helps map out where the action is happening right now. Once you know which project you're looking at, *get_project* lets your agent pull basic metadata for a specific protocol or dApp. This isn't about money; it’s about identity. You get details like its official category, descriptive text, and general info needed to classify the asset. It’s quick reference material when you need context on something new. For deep fundamental analysis, *get_project_metrics* is your go-to tool. This function generates time-series data points for one specific project over an extended period. You're talking about generating historical data for things like revenue figures, Total Value Locked (TVL), and active user counts. Running this through the agent lets you track how a protocol’s fundamental health has changed month by month or quarter by quarter. You can use these tools together. First, your agent runs *list_projects* to see all the names in the game. Then, if you're interested in one like Uniswap, it uses *get_project* to grab its basic details. After that, for the real money talk, it hits *get_project_metrics* to pull years of revenue and TVL data on that specific protocol. When you want to step back from a single project and understand market dynamics—say, comparing DeFi protocols against gaming tokens—you kick off with *get_market_metrics*. It provides the aggregated view needed to compare sectors side-by-side. This setup means your agent can build out complex research reports. You're not limited to just checking current prices; you've got historical context, sector comparison data, and project identity metadata all wired up for deep work. ## Tools ### get_market_metrics Retrieves aggregated, high-level metrics for the total crypto market sector. ### get_project_metrics Returns historical time-series data, including revenue, TVL, and active users, for one specific project. ### get_project Fetches basic details and metadata (like category or description) for a single crypto project. ### list_projects Outputs a list of all blockchain and dApp projects currently tracked by the server. ## Prompt Examples **Prompt:** ``` List all crypto projects tracked by Token Terminal. ``` **Response:** ``` I've retrieved the list of tracked projects. There are over 100 projects including Ethereum, Solana, Uniswap, and Aave. Would you like to see details for a specific one? ``` **Prompt:** ``` Show me the historical revenue and TVL for Ethereum over the last month. ``` **Response:** ``` Fetching metrics for Ethereum... In the last 30 days, Ethereum generated approximately $250M in revenue with a TVL maintaining around $50B. Would you like the daily breakdown? ``` **Prompt:** ``` What is the current aggregated market data for the crypto sector? ``` **Response:** ``` Accessing market metrics... The total crypto market revenue across all tracked protocols is currently trending upwards, led by the L1 and DeFi sectors. I can provide specific sector growth rates if needed. ``` ## Capabilities ### List all tracked projects Retrieve a complete list of blockchains and dApps that TokenTerminal monitors. ### Get project metadata Fetch detailed information (categories, descriptions) for a specific crypto protocol or dApp. ### Calculate historical metrics Generate time-series data points—like revenue, TVL, and active users—for a chosen project over time. ### Analyze market health Get current aggregated metrics covering the total crypto market sector's performance and trends. ## Use Cases ### A new protocol needs due diligence. You hear about Protocol X. You ask your agent to first use `list_projects` to confirm it's tracked, then `get_project` for its description and category. Finally, you run `get_project_metrics` to see if it has a solid history of revenue or TVL over the last year. ### Comparing two competing DeFi platforms. You want to compare Platform A vs. Platform B's performance over Q3. You instruct your agent to run `get_project_metrics` twice—once for each platform, specifying the date range and metrics (TVL/Revenue). This lets you build a direct comparison chart. ### Checking overall market sentiment. You need an immediate snapshot of the crypto sector. You use `get_market_metrics` first to check if L1s or DeFi are trending up. If they are, you then run `list_projects` to see which specific protocols might be driving that upward movement. ### Building a market index tracker. You're coding an internal tool and need financial data endpoints. You use `get_project` to validate the metadata format, then feed those project IDs into your workflow to calculate metrics using `get_project_metrics` in a structured manner. ## Benefits - Analyze deep financials without leaving your agent. You can calculate historical metrics for a protocol—TVL, revenue, active users—using `get_project_metrics` directly within your chat interface. - Understand the entire sector's health immediately. Use `get_market_metrics` to see aggregated data and spot which sectors are leading right now, without needing individual reports. - Map out the market landscape quickly. Running `list_projects` gives you a complete roster of tracked protocols, allowing your agent to narrow down potential research targets instantly. - Get instant project context. If you find an unknown ticker, use `get_project` to pull its official description and category metadata before wasting time researching it elsewhere. - Build verifiable arguments. By chaining tools—like listing projects and then running metrics on one—you create a clear data trail for your analysis. ## How It Works The bottom line is: you stop searching for data and start asking questions that get answered with financial metrics. 1. Subscribe to this server and provide your Token Terminal API Key. 2. Tell your AI agent what data you need (e.g., 'What was Ethereum's TVL last quarter?'). 3. The agent runs the necessary tool calls, retrieves the structured data, and presents the final analysis. ## Frequently Asked Questions **How do I list all crypto projects using the TokenTerminal (Crypto Financial Data) MCP Server?** You run `list_projects`. This function returns a comprehensive list of all tracked blockchains and dApps, helping you quickly identify which protocols are available for deeper analysis. **What should I use if I want to compare revenue across different projects?** You need `get_project_metrics`. You must call this tool multiple times—once for each project ID and specifying the 'revenue' metric in each call—to generate a consolidated comparison. **Can I find out basic info about a protocol using TokenTerminal (Crypto Financial Data) MCP Server?** Yes, use `get_project`. This tool pulls core metadata like the project's official description and its category tags. It’s useful for initial due diligence. **Does get_market_metrics give me specific protocol data?** No. `get_market_metrics` provides aggregated market data—the big picture of the entire crypto sector. If you need metrics for one specific protocol, use `get_project_metrics`. **What happens if I forget my API Key when calling list_projects?** You must provide a valid Token Terminal API key in your client configuration. The server will return an authentication error and refuse to execute the `list_projects` call until the key is correctly supplied. **Can I set a specific date range when using the get_project_metrics tool?** Yes, you can define a start and end date for your data retrieval. This allows you to scope historical time-series metrics (like TVL or revenue) down to precise periods, rather than pulling all available records. **Can I filter aggregated data when calling get_market_metrics by blockchain or sector?** The `get_market_metrics` tool accepts parameters that let you narrow the focus. You can request metrics for a specific L1 chain, DeFi category, or other defined market segments. **If I run many calls, like get_project followed by multiple get_project_metrics, is there a usage limit?** Yes, the API enforces rate limits to manage server load. If you exceed the allowed number of requests in a time window, your client will receive a 429 error, and you'll need to wait before retrying. **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.