Skip to main content

​
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

Zero Installation

No npm, no npx, no local dependencies. Just add a URL to your MCP client.

Secure OAuth

Browser-based authentication with your Messari API key. No keys in config files.

Intelligent Queries

Single powerful tool that understands your questions and queries the right data.

Always Up-to-Date

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
  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]
  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: 
{
  "mcpServers": {
    "messari": {
      "url": "https://mcp.messari.io/mcp"
    }
  }
}

​
Cursor

Add to your Cursor MCP configuration: 
{
  "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.

​
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.

​
Available Tools

The hosted MCP server provides the following tools:
ToolPurpose
ask_messariAI-powered natural language queries across Messari’s data platform
get_timeseries_catalogDiscover available datasets, metrics, and granularities from the Messari Timeseries API
get_timeseriesQuery timeseries data for crypto assets, protocols, and networks from the Messari Timeseries API
create_deep_researchStart an async deep research report on any crypto topic
get_deep_researchCheck status and retrieve a completed deep research report
list_deep_researchList 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

Market Data

Real-time prices, volumes, and market caps for 40,000+ crypto assets

On-Chain Metrics

TVL, active addresses, fees, and transactions for 25+ networks and 200+ protocols

Fundraising

Funding rounds, M&A deals, investors, and company valuations

Token Unlocks

Vesting schedules, allocation breakdowns, and upcoming unlock events

News

Aggregated from 500+ sources with AI summarization

Research

Messari’s proprietary reports, diligence analyses, and quarterly reviews

Signals

Social mindshare and sentiment data from X/Twitter

Timeseries Data

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
  • 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: