# Santiment MCP

> Santiment (On-chain, Social & Dev Metrics for Crypto) connects deep market data directly to your AI agent. You can track historical performance metrics (like daily active addresses or price changes), compare multiple crypto assets side-by-side, and screen the entire market for specific development or activity thresholds. It lets you get institutional-grade crypto intelligence without writing complex API calls.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** crypto-metrics, on-chain-data, social-sentiment, developer-activity, market-intelligence

## Description

You connect **Santiment** right into your agent, giving it instant access to deep crypto market data. It handles on-chain activity metrics, social sentiment scores, and developer development volume across thousands of assets. You can run complex analyses using natural language without ever writing a complicated API call yourself.

To start analyzing anything, you first need identifiers. The `list_projects` tool runs through every available crypto project and spits out a list of valid slugs. This tells your agent exactly which unique ID it needs to use when querying any metrics. You gotta run this before you can get accurate data on any coin.

When you’re ready for the numbers, you'll typically start with historical context. If you want to track how one asset has performed over time—say, checking daily active addresses or price fluctuations for Bitcoin—you use `get_metric_timeseries`. This tool retrieves a full time-series data set for a single metric and a specific crypto slug across any date range you define.

You ain't always looking at just one coin. If you wanna see how several assets stacked up against each other over the same period, you use `get_metric_multiple_slugs`. This function takes one metric and feeds it data for multiple crypto slugs in a single request. You can compare performance metrics—like market cap or total volume—across a handful of different tokens without running separate queries.

But sometimes, you don't know what you're looking for; you just know the conditions. That’s where `filter_projects_by_metric` comes in. This tool screens the entire market to find projects that hit specific metric thresholds. For instance, you could ask your agent to screen for all tokens with developer activity above a certain count or those showing unusual price action relative to their total market cap. It narrows down the field instantly.

The system lets you look at institutional-grade crypto intelligence without needing deep background in data science or complex query writing. You can track historical performance metrics—like daily active addresses, circulating supply changes, or raw price movements—for single assets using `get_metric_timeseries`. Or, if you want to compare the health of Ethereum versus Solana side-by-side, you run `get_metric_multiple_slugs`.

If your goal is market discovery, `filter_projects_by_metric` is key. You can use it to identify opportunities—maybe finding assets with high on-chain volume but low social media mention counts. It lets you test specific criteria against the whole asset universe. Remember, every piece of data you pull starts with a valid slug from `list_projects`. This structured approach means your agent always works with accurate identifiers, making the entire process reliable and fast.

## Tools

### filter_projects_by_metric
Screens the market to find projects that meet a defined metric threshold (e.g., top 10 by DAA).

### get_metric_multiple_slugs
Fetches time-series data for one specific metric across multiple crypto asset slugs.

### get_metric_timeseries
Retrieves historical time-series data for a single metric and a single asset slug over a period of time.

### list_projects
Lists all available crypto projects and their valid identifiers (slugs) needed for querying metrics.

## Prompt Examples

**Prompt:** 
```
Show me the daily active addresses for bitcoin from 2023-10-01 to now.
```

**Response:** 
```
I've retrieved the daily active addresses for Bitcoin. The data shows a peak of 1.2M addresses on October 25th, with a steady average of 950k throughout the period.
```

**Prompt:** 
```
Compare the social volume of ethereum and solana for the last 7 days.
```

**Response:** 
```
Comparing social volume: Ethereum maintained a higher baseline, but Solana saw a 40% spike in mentions yesterday following the latest network update.
```

**Prompt:** 
```
Find the top 5 projects with the highest developer activity in the last 30 days.
```

**Response:** 
```
Based on developer activity (dev_activity) over the last 30 days, the top 5 projects are: 1. Cardano, 2. Polkadot, 3. Ethereum, 4. Cosmos, and 5. Chainlink.
```

## Capabilities

### Find available asset slugs
Runs through all projects and returns a list of valid identifiers needed for metric queries.

### Track historical metrics for one asset
Retrieves time-series data (like daily active addresses or price) for a specific crypto slug over a user-defined date range.

### Compare multiple assets at once
Fetches the same metric's historical data across several different asset slugs in a single request.

### Filter projects by specific thresholds
Screens through the entire market to find tokens that meet predefined criteria, such as high developer activity or low price action.

## Use Cases

### Validating a major trend
A crypto analyst wants to prove whether the recent spike in ETH price was supported by real network activity. They first run `list_projects` to confirm 'ethereum' is the correct slug, then use `get_metric_timeseries` with the `daily_active_addresses` metric over the last year to build a clear historical graph for their presentation.

### Benchmarking competitors
A quantitative trader needs to compare the social volume of top DeFi protocols (Aave, Compound, Uniswap) in one query. They use `list_projects` to get all three slugs, and then run `get_metric_multiple_slugs` to fetch the 'social_volume' metric for a 7-day period.

### Searching for undervalued assets
A developer is looking for promising protocols that aren't popular yet. They use `filter_projects_by_metric` to search the entire market, setting thresholds for 'high_dev_activity' but low 'price_action'. This immediately surfaces potential targets they otherwise would have missed.

### Quick status check
You need a quick metric snapshot of Bitcoin and Ethereum. You don't want history, just the current state. You use `get_metric_multiple_slugs` to pull the latest 'price_usd' for both slugs in one go.

## Benefits

- Track history without writing queries: Use `get_metric_timeseries` to plot a metric's performance over years. You specify the asset (e.g., ETH) and the timeframe; the server delivers the data points.
- Compare many assets at once: Need to see how Bitcoin, Ethereum, and Solana stacks up? Pass multiple slugs into `get_metric_multiple_slugs` to get a single comparison view for any given metric.
- Find hidden opportunities: Forget manual screening. Use `filter_projects_by_metric` to automatically identify assets that meet complex criteria (e.g., high developer count, low price action).
- Start with valid IDs: Don't guess slugs. Run `list_projects` first to get a clean list of identifiers, ensuring every subsequent tool call is accurate.
- Deep data access: The server gives you three layers of market intelligence—on-chain activity, social mentions, and developer volume—all available through your AI client.

## How It Works

The bottom line is that your AI client translates natural language into specific tool calls to pull deep crypto metrics from Santiment.

1. First, run `list_projects` to get a list of valid crypto slugs.
2. Next, tell your AI agent what you want. If you need historical data for one asset, use `get_metric_timeseries`. If you're comparing several, use `get_metric_multiple_slugs`; if you're searching the market, use `filter_projects_by_metric`.

## Frequently Asked Questions

**How do I find the correct slug for a new crypto asset using list_projects?**
Run `list_projects`. This tool queries all available projects and spits out a comprehensive, up-to-date list of valid slugs. You pick your slug from this list to use in any other metric query.

**Should I use get_metric_timeseries or get_metric_multiple_slugs?**
Use `get_metric_timeseries` if you are only tracking one asset over time. Use `get_metric_multiple_slugs` when your goal is to compare the same metric across two or more assets simultaneously.

**How does filter_projects_by_metric work?**
This tool screens the market based on thresholds you set. For example, you can tell it: 'Show me all tokens where developer activity is above X.' It doesn't show history; it shows current snapshots that match your criteria.

**What kind of metrics can I track?**
The server tracks three main types of data: on-chain metrics (like daily active addresses), social sentiment, and developer development volume. You specify the metric name when querying.

**What is required before I can use `list_projects`?**
You must subscribe to the server and enter your Santiment API Key. The tool won't run without valid credentials, so make sure your client agent is configured with the correct key first.

**Are there rate limits when I use `get_metric_timeseries`?**
Yes, continuous high-volume querying can hit usage limits. For large historical data pulls, it’s best practice to break your requests into smaller, sequential batches rather than one massive query.

**When should I use `get_metric_multiple_slugs` instead of a general prompt?**
Use this tool when you need guaranteed timeseries data for specific assets across the same metric. A general prompt might compare them, but the function delivers structured, comparable datasets.

**Can I combine criteria in `filter_projects_by_metric`?**
Yes. You can define complex filtering logic by specifying multiple thresholds and metrics. The system processes these conditions together to narrow down your asset list effectively.

**How can I find the correct slug for a specific cryptocurrency?**
You can use the `list_projects` tool. It provides a paginated list of all available assets and their corresponding slugs used for metric queries.

**Can I compare the price of multiple assets at once?**
Yes! Use the `get_metric_multiple_slugs` tool. Just provide the metric (e.g., 'price_usd') and an array of slugs to get a combined timeseries for comparison.

**Is it possible to find projects based on their network activity levels?**
Absolutely. Use the `filter_projects_by_metric` tool to find projects that meet specific criteria, such as having more than 1000 daily active addresses over a certain period.