Skip to main content

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

​
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

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

​
The ask_messari Tool

The hosted MCP server provides a single, powerful tool: ask_messari 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

​
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”)

​
API Permissions

Access to the hosted MCP server requires a Messari Enterprise subscription with access to the AI Toolkit. Each query made through the ask_messari tool consumes Messari AI credits from your account. For more information on API tiers, permissions, and rate limits, see our API Permissions documentation.

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