> ## Documentation Index
> Fetch the complete documentation index at: https://docs.messari.io/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP Server
> Fully hosted Model Context Protocol server for accessing Messari's AI-powered crypto intelligence through any MCP client
# Messari MCP Server
The hosted MCP server provides the simplest way to connect AI assistants like Claude Desktop, Cursor, and Claude Code to Messari's crypto intelligence platform. Unlike traditional MCP servers that require local installation, this server is fully hosted—just add a URL and authenticate. It provides multiple tools for AI-powered research, deep analysis, and direct timeseries data access.
## Key Benefits
No npm, no npx, no local dependencies. Just add a URL to your MCP client.
Browser-based authentication with your Messari API key. No keys in config
files.
Single powerful tool that understands your questions and queries the right
data.
Hosted infrastructure means you always have the latest capabilities.
## Quick Setup
Add the Messari MCP server to your AI assistant in seconds:
**MCP Server URL:**
```
https://mcp.messari.io/mcp
```
When you first connect, you'll be redirected to authenticate with your Messari API key through a secure OAuth flow.
## Configuring MCP Clients
### Claude Connectors
To add Messari as a custom connector in Claude:
1. Navigate to [claude.ai/settings/connectors](https://claude.ai/settings/connectors)
2. Click **Add custom connector**
3. Enter the MCP server URL: `https://mcp.messari.io/mcp`
4. Click **Connect** and enter your Messari API key when prompted
### OpenAI ChatGPT App
To add Messari as a custom App in ChatGPT:
1. Navigate to (chatgpt.com/admin/ca#available)\[[https://chatgpt.com/admin/ca#available](https://chatgpt.com/admin/ca#available)]
2. Enable developer mode.
3. Click **Create**
4. Enter the MCP server URL: `https://mcp.messari.io/mcp`
5. Leave Authentication as OAuth.
6. Click **Creaet** and enter your Messari API key when prompted
### Claude Code
Add to your Claude Code MCP settings:
```json theme={null}
{
"mcpServers": {
"messari": {
"url": "https://mcp.messari.io/mcp"
}
}
}
```
### Cursor
Add to your Cursor MCP configuration:
```json theme={null}
{
"mcpServers": {
"messari": {
"url": "https://mcp.messari.io/mcp"
}
}
}
```
### Other MCP Clients
Any MCP-compatible client that supports remote servers can connect using:
* **URL**: `https://mcp.messari.io/mcp`
* **Authentication**: OAuth 2.0 (handled automatically)
## Authentication Flow
When you first connect:
1. Your MCP client will detect the server requires authentication
2. A browser window opens to the Messari OAuth page
3. Enter your Messari API key
4. You're authenticated and ready to query
Your API key is securely stored and used to authenticate requests to Messari's
services. You can obtain an API key from your [Messari account
settings](https://messari.io/account/api).
## API Permissions
Access to the MCP server requires a **Messari Enterprise subscription** with access to the **AI Toolkit**. Access to each tool and its underlying data depends on your API key's subscription tier. Queries made through `ask_messari` consume Messari AI credits from your account.
For more information on API tiers, permissions, and rate limits, see our [API Permissions documentation](/api-reference/permissions).
## Available Tools
The hosted MCP server provides the following tools:
| Tool | Purpose |
| ------------------------ | ------------------------------------------------------------------------------------------------ |
| `ask_messari` | AI-powered natural language queries across Messari's data platform |
| `get_timeseries_catalog` | Discover available datasets, metrics, and granularities from the Messari Timeseries API |
| `get_timeseries` | Query timeseries data for crypto assets, protocols, and networks from the Messari Timeseries API |
| `create_deep_research` | Start an async deep research report on any crypto topic |
| `get_deep_research` | Check status and retrieve a completed deep research report |
| `list_deep_research` | List your deep research jobs |
## The `ask_messari` Tool
This AI-powered tool understands your questions in natural language and intelligently queries across Messari's entire data platform.
### Data Sources
Real-time prices, volumes, and market caps for 40,000+ crypto assets
TVL, active addresses, fees, and transactions for 25+ networks and 200+
protocols
Funding rounds, M\&A deals, investors, and company valuations
Vesting schedules, allocation breakdowns, and upcoming unlock events
Aggregated from 500+ sources with AI summarization
Messari's proprietary reports, diligence analyses, and quarterly reviews
Social mindshare and sentiment data from X/Twitter
Historical and real-time timeseries metrics across 80+ datasets via the Messari Timeseries API
### Example Queries
**Asset & Protocol Information:**
* "What is Solana?"
* "Explain Uniswap v4's new features"
* "Compare Ethereum vs Solana on-chain activity"
**Market Data:**
* "What is Bitcoin's current price and 24h volume?"
* "Show me the top 10 assets by market cap"
**Fundraising & Investors:**
* "Who invested in Arbitrum?"
* "Recent DeFi funding rounds this month"
**Token Unlocks:**
* "When is the next ARB token unlock?"
* "What percentage of SOL supply is currently staked?"
**On-Chain Analysis:**
* "What is Aave's TVL?"
* "Solana daily active addresses this week"
**News & Events:**
* "Latest news about Ethereum"
* "What happened with FTX?"
### Best Practices
For complex or multi-faceted questions, consider making multiple focused
queries instead of one loaded question. Breaking down questions into specific,
single-topic calls often yields better depth and accuracy.
**Quantitative queries work best when you specify:**
* The exact metric (e.g., "TVL", "market cap", "24h trading volume")
* The asset or protocol name
* Timeframe if relevant (e.g., "last 30 days", "YTD")
* Comparison baseline if needed (e.g., "vs last month", "vs Ethereum")
## Timeseries Tools
The MCP server provides direct access to Messari's Timeseries API through two tools.
### `get_timeseries_catalog`
Lets the AI agent discover what timeseries data is available — including dataset slugs, supported time granularities, available metrics, and entity types. The agent uses this to determine what can be queried before fetching data. The datasets returned depend on your subscription tier.
### `get_timeseries`
Lets the AI agent query timeseries data points for crypto assets, protocols, networks, and more. Covers 80+ datasets with configurable time ranges and granularities.
### Example Queries
* "What is Bitcoin's daily price over the last 90 days?"
* "Show me Ethereum's weekly active addresses for the past year"
* "Compare daily trading volumes for Bitcoin and Solana this quarter"
* "What are the available timeseries datasets for DeFi protocols?"
* "Get Aave's TVL trend over the last 6 months"
## Troubleshooting
### Authentication Issues
**OAuth window doesn't open:**
* Ensure your MCP client supports OAuth 2.0 authentication
* Check that popups aren't blocked in your browser
* Try restarting your MCP client
**Invalid API key error:**
* Verify your API key at [messari.io/account/api](https://messari.io/account/api)
* Ensure your API key has the necessary permissions
* Check that your API key hasn't expired
### Connection Issues
**Server unreachable:**
* Verify your internet connection
* Check if `https://mcp.messari.io` is accessible
* Try again in a few minutes if there's a temporary outage
### Query Issues
**Empty or unexpected responses:**
* Try rephrasing your question more specifically
* Break complex questions into multiple simpler queries
* Ensure you're asking about supported data types
## Support
Need help? Contact us:
* **Documentation**: [docs.messari.io](https://docs.messari.io)
* **API Support**: [messari.io/contact](https://messari.io/contact)
* **API Key Issues**: [messari.io/account/api](https://messari.io/account/api)