# CoinLore MCP

> CoinLore gives your AI agent instant access to massive, real-time crypto data. It delivers global market stats, detailed price history for thousands of coins, top exchange listings, and social media sentiment metrics. Need to analyze market movements or track asset performance? This MCP gets you the structured numbers directly from any compatible client.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** cryptocurrency, bitcoin-prices, market-data, crypto-trading, altcoins

## Description

Need to know what's happening in crypto without opening fifteen different tabs? CoinLore feeds your AI agent raw data straight from the source. You can pull global statistics, like total market cap and Bitcoin dominance, right into your chat window. Wanna deep dive on a specific asset? Just ask for its current price, volume details, or historical performance over the last year. It also keeps an eye on what people are saying about coins on social media. This means you don't just get numbers; you get context—who's buying and why. Because Vinkius hosts this MCP in their catalog, your agent can pull all these different data types together into one cohesive analysis, letting you focus on the insights instead of the tabs.

## Tools

### list_assets
Provides a simple list of all available cryptocurrencies tracked by CoinLore.

### get_coin_info
Gets basic, static information and metadata for a single cryptocurrency.

### get_coin_markets
Lists the top 50 exchanges and trading markets available for a specific coin ID.

### get_exchange
Provides details on an exchange, including its top 100 supported trading pairs.

### list_exchanges
Lists every exchange that the service supports and tracks data for.

### get_global_stats
Retrieves overall market statistics like total cap and volume across all cryptocurrencies.

### get_movers
Shows the top 20 crypto assets that gained or lost value over specified timeframes.

### get_ohlcv
Fetches daily Open, High, Low, Close, and Volume history for a coin over 365 days.

### get_social_stats
Pulls community metrics from platforms like Twitter and Reddit for a given asset.

### get_ticker
Retrieves detailed, up-to-the-minute price, volume, and supply data for specific coins.

### list_tickers
Gets current tick data across multiple specified coins simultaneously.

## Prompt Examples

**Prompt:** 
```
What is the current global crypto market cap and BTC dominance?
```

**Response:** 
```
I've retrieved the global stats: The total market cap is approximately $2.45 trillion with a 24h volume of $85 billion. Bitcoin dominance currently stands at 52.1%.
```

**Prompt:** 
```
Show me the top 20 gainers in the last 24 hours.
```

**Response:** 
```
Fetching market movers... The top gainer is 'CoinX' with a 24.5% increase, followed by 'TokenY' at 18.2%. Would you like more details on any of these?
```

**Prompt:** 
```
Get the price and social stats for Ethereum (ID: 80).
```

**Response:** 
```
Ethereum (ETH) is currently trading at $3,450. On the social side, it has over 3 million Twitter followers and high engagement on Reddit today.
```

## Capabilities

### Track global market health
Get overall statistics for the crypto market, such as total volume and market capitalization.

### Benchmark specific coins
Fetch detailed price metrics and supply data for any individual cryptocurrency ID.

### Analyze historical trends
Pull daily Open, High, Low, Close, and Volume (OHLCV) prices spanning the last 365 days to spot patterns.

### Spot market winners and losers
Instantly identify the top-performing and bottom-performing assets over different timeframes.

### Map exchange activity
List all supported exchanges and check their specific trading pairs or top markets.

### Gauge community mood
Pull social media metrics from Twitter and Reddit to see how the public feels about an asset.

## Use Cases

### Assessing market risk after a sudden dip
A client asks: 'What happened to ETH last week?' Your agent uses get_ohlcv to pull the specific 7-day price action, then runs get_social_stats to check if negative news or just natural sell-off drove the drop.

### Comparing investment potential across sectors
You ask for a comparison of assets in the DeFi sector. Your agent first calls list_assets to scope the coins, then uses get_ticker and get_global_stats to pull current pricing and market cap data points.

### Building an automated trading alert system
The developer runs a script that first lists all supported exchanges using list_exchanges. Then, it uses get_coin_markets for each exchange to check liquidity across the top pairs.

### Preparing weekly market briefing slides
Instead of manually gathering data, your agent runs get_global_stats and then gets_movers to auto-populate the 'Market Summary' slide with the current leaders and overall market health figures.

## Benefits

- Instead of manually checking CoinMarketCap, you can get overall global statistics using get_global_stats directly in your chat. It's all in one place.
- You never have to jump between Twitter and a charting tool again. Get the current price from get_ticker and immediately follow up with social sentiment data from get_social_stats for context.
- Need to audit performance? Use get_ohlcv to pull 365 days of structured price history, which is way cleaner than downloading spreadsheet dumps.
- Stop guessing what's hot. The get_movers tool instantly shows you the top gainers and losers across different timeframes so your analysis starts with the right assets.
- When building a report, use list_assets first to scope out all available coins, then use get_coin_info for basic metadata before diving into complex price data.

## How It Works

The bottom line is, you talk to your agent using plain English, and it uses these tools to pull structured financial data into the chat.

1. Subscribe to this MCP in Vinkius.
2. Initialize the connection; no API key is needed for basic access.
3. Use natural language prompts with your AI client (like Claude or Cursor) to query crypto market data.

## Frequently Asked Questions

**How do I check global market stats with get_global_stats?**
Just ask your agent for 'overall crypto market statistics.' It uses get_global_stats to pull the total cap, volume, and dominance figures into the chat.

**Can I find out what coins are trading on which exchanges using get_coin_markets?**
Yes. You ask for a specific coin's markets, and it uses get_coin_markets to list its top 50 exchange listings and pairs.

**How do I pull historical prices with get_ohlcv?**
Specify the coin ID and the time frame (e.g., 'Show me BTC OHLCV for the last year'). The tool fetches structured daily price data.

**Does list_assets give me every single crypto coin?**
It provides a lightweight, current list of all coins tracked by CoinLore. It's a good starting point before you need to get specific metadata using get_coin_info.

**What is the difference between get_ticker and get_ohlcv?**
get_ticker gives you real-time, minute-by-minute price snapshots. get_ohlcv provides structured daily records spanning a full year or more for trend analysis.

**How do I use get_social_stats to track community sentiment?**
It pulls social metrics from Twitter and Reddit for a coin. You instantly gauge public interest by analyzing the raw engagement data.

**What is the difference between list_assets and get_coin_info?**
list_assets provides a lightweight roster of every available coin ID. Use get_coin_info to retrieve detailed, static metadata for one specific asset.

**When should I use get_exchange instead of list_exchanges?**
Use get_exchange when you need deep details on a platform or its top trading pairs. list_exchanges only gives you the general roster of all supported exchanges.

**How can I see which cryptocurrencies are performing best today?**
You can use the `get_movers` tool. It retrieves the top 20 gainers and losers in the market based on your preferred timeframe (1h, 24h, or 7d).

**Is it possible to get historical price data for a specific coin?**
Yes! The `get_ohlcv` tool provides 365 days of daily Open, High, Low, Close, and Volume history for any coin using its CoinLore ID.

**Can I check the social media popularity of a cryptocurrency?**
Absolutely. Use the `get_social_stats` tool with a coin's ID to retrieve metrics from Twitter and Reddit, including follower counts and engagement stats.