# LunarCrush MCP > LunarCrush provides real-time social intelligence for crypto assets. Your AI agent uses this server to monitor community sentiment, track key proprietary metrics like Galaxy Score and AltRank, and access live market data for thousands of digital coins. You can compare a coin's social buzz against its current price, making it easy to spot potential trends before the rest of the market catches on. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** crypto-intelligence, social-metrics, bitcoin-tracking, altcoin-analysis, market-sentiment ## Description LunarCrush gives your AI agent deep social intelligence on crypto assets. This server lets you monitor community sentiment and track proprietary metrics—like Galaxy Score and AltRank—for thousands of digital coins. You're checking if a coin's buzz is matching the market hype. **Getting Started: Building Your Watchlist** Start by building your asset list. Use `list_assets` to grab the full roster of supported crypto assets. This function returns all available symbols, letting you filter that data right away—you can narrow it down by a specific symbol or by rank if you only want to see the top dogs. You'll get a structured list that lets your agent build out reports on demand. **Deep Dive into Community Buzz: The Raw Data** Want to know what people are *actually* saying? Use `get_social_metrics`. This tool pulls granular data points for any specific coin. It gives you mention counts, engagement rates, and the overall calculated sentiment score. You're not just getting a number; you're seeing the raw health of the community discussion around that asset. **Measuring Social Performance: AltRank** To see how an asset stacks up against the competition, run `get_altrank`. This function gives you a coin’s AltRank score. Think of it like this: it ranks the asset's current social buzz performance against every other crypto in the market. It immediately shows if a coin is trending hard or getting ignored. **Calculating Combined Health Scores: Galaxy Score** For a quick, single measure of total health, call `get_galaxy_score`. This tool calculates a combined Galaxy Score for any given asset. What it does under the hood is cross-reference both historical market data and current social volume into one score. It's way faster than looking at metrics separately. **Market Context: Real-Time Finance** No point analyzing buzz without knowing the price action. Use `get_market_metrics` to pull real-time financial information for any coin. This returns live data points, including the current market price, total trading volume over a set period, and the asset's total market capitalization. You combine this live money flow with your social metrics to get the full picture. **How It Works Together** Your agent uses these tools sequentially. First, it grabs the list of assets using `list_assets`. Then, for a specific coin, it calls `get_social_metrics` to nail down sentiment. Next, it runs `get_altrank` to see how that buzz ranks globally. It simultaneously pulls `get_market_metrics` to know what the price is doing right now. Finally, it wraps all that data up by running `get_galaxy_score`, giving you a comprehensive, single score that tells you if the coin's social life matches its financial backing. ## Tools ### get_altrank Retrieves an AltRank score, showing a coin's social performance relative to the entire crypto market. ### list_assets Provides a list of all supported crypto assets; you can filter this list by symbol or rank to focus your analysis. ### get_galaxy_score Calculates a combined Galaxy Score for a coin by cross-referencing its social and historical market data. ### get_market_metrics Pulls real-time financial information, including the current price, trading volume, and total market cap for any given coin. ### get_social_metrics Gathers detailed social data points like mention counts, engagement rates, and overall sentiment surrounding a specific crypto asset. ## Prompt Examples **Prompt:** ``` List the top 10 crypto assets sorted by Galaxy Score. ``` **Response:** ``` I've retrieved the top assets. Currently, Bitcoin (BTC) leads with a Galaxy Score of 78, followed by Ethereum (ETH) at 74. Would you like to see the social metrics for any of these? ``` **Prompt:** ``` What is the current AltRank for Solana (SOL)? ``` **Response:** ``` Solana (SOL) currently has an AltRank of 12. This indicates very strong social performance relative to the rest of the market. Its social engagement has increased by 15% in the last 24 hours. ``` **Prompt:** ``` Show me social engagement and sentiment for BTC over the last 24 hours. ``` **Response:** ``` For Bitcoin (BTC) in the last 24h: Social mentions are at 120k, engagement is up 5%, and the overall sentiment remains 'Bullish' at 72%. ``` ## Capabilities ### Compare Social Performance You can run `get_altrank` to immediately see how an asset's current buzz ranks against all other coins, giving instant market context. ### Calculate Combined Asset Health Score By calling `get_galaxy_score`, your agent combines social volume and market history into one single score for quick comparison across multiple assets. ### Pull Real-Time Market Metrics The `get_market_metrics` tool retrieves live data points, including current price, trading volume, and total market capitalization. ### Deep Dive into Community Buzz Use `get_social_metrics` to pull granular data like mention counts, engagement rates, and overall sentiment for a specific coin. ### Build an Asset Watchlist The `list_assets` function lets your agent retrieve the full list of supported coins, allowing you to build structured reports or filters on demand. ## Use Cases ### Investigating a sudden price spike A trader notices BTC's price jumped 15%. They ask their agent to check why. The agent runs `get_market_metrics` (confirming the jump) and then immediately follows up with `get_social_metrics`. If the sentiment is 'Bullish' but mentions are low, it suggests institutional buying rather than grassroots hype. ### Comparing altcoins in a sector An analyst needs to compare five Layer-1 competitors. Instead of manual lookups, they use `list_assets` to get the list, then run `get_galaxy_score` on all five. This provides an immediate, comparable score for their research report. ### Identifying undervalued assets A developer wants a watchlist of coins with strong community interest but low market cap. They use `list_assets` to filter by size, then run `get_altrank` and `get_market_metrics` together. High AltRank + Low Market Cap = Potential target. ### Checking for market correlation A user wants to know if Bitcoin's performance is dragging down minor coins. They run `get_altrank` on both BTC and a small altcoin simultaneously. A low AltRank score on the altcoin confirms its weakness relative to the overall market. ## Benefits - Spot early trends by combining `get_altrank` with `get_market_metrics`. You don't just see a high price; you see if the community buzz (AltRank) is actually supporting that price action. This combination helps separate hype from solid fundamentals. - Move beyond simple charts. By using `get_social_metrics`, your agent can give you sentiment—is the overall mood 'Bullish' or 'Bearish'? This qualitative data adds a critical layer of context missing from standard charting platforms. - Benchmark assets instantly with `get_galaxy_score`. Instead of looking at one coin in isolation, this single score combines market performance and social volume, letting you compare 10 coins against each other efficiently. - Automate watchlist creation. Use `list_assets` to pull a filtered list of the top N coins by rank or symbol, then feed that resulting list into `get_market_metrics` to get instant data for dozens of assets at once. - Validate hype vs. reality. If an asset has high social mentions but poor market metrics (from `get_market_metrics`), this server lets you flag it instantly. It helps cut through the noise. ## How It Works The bottom line is: your agent runs multiple crypto analysis tools in sequence to build one complete picture of an asset's health. 1. First, ask your AI agent to identify what data you need. For example: 'Give me the market metrics and social score for BTC.' 2. The agent then calls multiple tools—like `get_market_metrics` and `get_social_metrics`—and combines their outputs into a single reply. 3. You get back structured, cross-referenced data that tells you both the technical performance (price) and the behavioral performance (buzz). ## Frequently Asked Questions **How do I find out what coins are supported by LunarCrush? Using `list_assets`?** Run the `list_assets` tool. It returns a complete list of all assets the server supports, and you can filter this initial data set by symbol or rank if needed. **Can I compare social buzz against market cap? Which tools do I use?** Yes. You need to combine `get_social_metrics` for the sentiment/mentions, and then run `get_market_metrics` to pull the real-time market capitalization. The agent will stitch these two data points together for comparison. **What is better: AltRank or Galaxy Score?** It depends on your goal. Use `get_altrank` when you need to know how an asset stacks up against the entire market's buzz. Use `get_galaxy_score` when you want a holistic, combined score of social activity and historical performance. **Do I have to run multiple tools for one coin? Is it efficient?** No. Your agent is designed to manage the sequence. You can ask for 'everything'—and the agent will call `get_market_metrics`, `get_social_metrics`, and others sequentially, delivering a single, comprehensive result. **What do I need to successfully run `get_galaxy_score`?** You must provide a valid LunarCrush API Key for authentication. The key grants your AI client access, and you'll need an active subscription linked to that credential. **Am I limited when running multiple checks with `get_social_metrics`?** Yes, there are rate limits on the number of calls in a short period. We recommend batching your requests or implementing an exponential backoff strategy in your agent code. **Does `get_market_metrics` provide historical price points, or just real-time data?** It provides current, real-time market metrics like price and volume. If you need deeper historical charts, you'll have to use a dedicated charting API outside of this server. **How can I use `list_assets` to filter assets by ranking or category?** You can pass specific parameters like rank ranges or categories into the function call. This allows you to narrow down the list significantly without needing multiple searches. **What does the Galaxy Score represent for a coin?** The Galaxy Score, retrieved via `get_galaxy_score`, indicates how a coin is performing relative to its own historical social and market performance. A higher score suggests stronger combined health. **How can I compare a coin's social performance against the entire market?** Use the `get_altrank` tool. It measures a coin's social performance relative to the entire crypto market, helping you identify assets that are gaining significant social traction. **Can I get social sentiment for specific time intervals?** Yes! The `get_social_metrics` tool allows you to specify an interval (1h, 24h, or 7d) to retrieve mentions, engagement, and sentiment for a specific coin symbol.