MCP Integration

Connect your agent to Opal.

Opal exposes a native Model Context Protocol server. Any MCP-compatible agent — Claude, custom tools built on the Anthropic SDK, or your own orchestration — can call Opal tools to research and analyse Solana markets.

Quick start

Add Opal's MCP server to your agent's configuration. The example below uses the Anthropic SDK, but any MCP client works.

// Configure the MCP server
const client = new McpClient({
  server: "https://mcp.heyopal.ai",
  apiKey: process.env.OPAL_API_KEY,
})

// Call a tool
const result = await client.callTool({
  name: "top_tokens_by_volume",
  arguments: { limit: 5, window: "1h" },
})

console.log(result.tokens)

Create an API key in Settings → API keys. Choose its access when you create it: Read only, Account changes, or Rules and trading.

Available tools

top_tokens_by_volume

Top N tokens by 24h trading volume from the latest snapshot cycle.

token_snapshot

Latest snapshot data for a token, by symbol or address.

token_price_history

Recent price snapshots for a token over time — useful for trend analysis.

snapshot_stats

Summary statistics for the dataset: total snapshots, unique tokens, time range.

Authentication

Every MCP request is authenticated with an API key. All four tools are read-only market data — none of them places trades or connects to a wallet.

Need help?

MCP integration is new, and the docs above will expand as more developers start building. If something is missing or unclear, get in touch or message on X.