MCP Setup Guide

This guide helps you quickly configure ChainStream MCP Server.

Prerequisites

Requirement	Details	How to Get
ChainStream Account	Registered account	Sign up
API Key	`X-API-KEY` for authentication	Dashboard → Apps → Create App
AI Client	Claude Desktop / Cursor / Custom client	Installed

MCP Endpoint

ChainStream provides a hosted MCP Server. No local installation required — connect directly via:

https://mcp.chainstream.io/mcp

Configuration Steps

Get API Key

Log in to ChainStream Dashboard
Navigate to Applications
Click Create New App and copy your API Key

Configure AI Client

Claude Desktop
Cursor IDE
Custom Client

Config file path:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Option A — Cloud endpoint (recommended):

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "headers": {
        "X-API-KEY": "your_api_key"
      }
    }
  }
}

Option B — Local npm package (stdio):

{
  "mcpServers": {
    "chainstream": {
      "command": "npx",
      "args": ["@chainstream-io/mcp"],
      "env": {
        "CHAINSTREAM_API_KEY": "your_api_key"
      }
    }
  }
}

If the file doesn’t exist, create it manually. If you have other MCP Server configurations, add the chainstream config to the existing mcpServers object.

Config file path: .cursor/mcp.json (project-level) or Cursor Settings → Features → MCP ServersOption A — Cloud endpoint:

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "headers": {
        "X-API-KEY": "your_api_key"
      }
    }
  }
}

Option B — Local npm package (stdio):

{
  "mcpServers": {
    "chainstream": {
      "command": "npx",
      "args": ["@chainstream-io/mcp"],
      "env": {
        "CHAINSTREAM_API_KEY": "your_api_key"
      }
    }
  }
}

Connect to the cloud endpoint via HTTP:

Endpoint	URL	Method
MCP Endpoint	`https://mcp.chainstream.io/mcp`	POST

Authentication: pass API Key via X-API-KEY header.Example Code:

import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
import { Client } from '@modelcontextprotocol/sdk/client/index.js';

const transport = new StreamableHTTPClientTransport(
  new URL('https://mcp.chainstream.io/mcp'),
  {
    requestInit: {
      headers: {
        'X-API-KEY': process.env.CHAINSTREAM_API_KEY
      }
    }
  }
);

const client = new Client({
  name: 'my-client',
  version: '1.0.0'
});

await client.connect(transport);

const { tools } = await client.listTools();
console.log('Available tools:', tools.map(t => t.name));

Restart Client

After configuration, completely quit and restart your AI client for changes to take effect.

Claude Desktop: Fully quit (not just minimize), then reopen
Cursor: Restart the IDE

Verify Configuration

Test Command

Enter the following test question in your AI client:

What is the SOL token on Solana? Is it safe?

Expected Result

If configured successfully, the AI should:

Call tokens_search to find the SOL token
Call tokens_analyze to get security and holder data
Return a natural language summary

If the AI doesn’t call the tool or returns an error, refer to Troubleshooting below.

Troubleshooting

Authentication failed

Possible causes:

API Key entered incorrectly
- Check for extra spaces
- Confirm complete copy
API Key revoked or expired
- Check key status in Dashboard
- Create a new key if needed
Wrong header name
- Cloud endpoint: use X-API-KEY header
- npm package: use CHAINSTREAM_API_KEY env var

Solutions:

Verify key in Dashboard → Applications
Test directly: curl -H "X-API-KEY: your_key" https://api.chainstream.io/v2/blockchain

Connection failed

Possible causes:

Network issues
- Check network connection
- Confirm access to https://mcp.chainstream.io
Configuration format error
- Check JSON format is correct
- Confirm URL spelling is correct

Solution:

curl -I https://mcp.chainstream.io/mcp

Config file not taking effect

Possible causes:

Config file path incorrect
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
JSON format error
- Use a JSON validator to check
Client not restarted
- Fully quit and restart

Solution:

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python -m json.tool

Tool call failed: Quota exceeded

Possible causes:

Plan quota exhausted
Request rate too high, triggering rate limit

Solutions:

Check quota usage in Dashboard
Upgrade plan for more quota

Data return delayed or timeout

Possible causes:

Network latency
Query data volume too large

Solutions:

Check network connection
Reduce data volume per query
Try again later

Next Steps

Tools Catalog

View all available tools and usage examples

AI Agent Tutorial

Build an AI trading assistant

Data Products

Access Methods

AI Agents

Compliance (KYT/KYA)

Tutorials

Recipes

Platform

Ecosystem

Reference

Prerequisites

MCP Endpoint

Configuration Steps

Verify Configuration

Test Command

Expected Result

Troubleshooting

Next Steps

Tools Catalog

AI Agent Tutorial

Data Products

Access Methods

AI Agents

Compliance (KYT/KYA)

Tutorials

Recipes

Platform

Ecosystem

Reference

​Prerequisites

​MCP Endpoint

​Configuration Steps

​Verify Configuration

​Test Command

​Expected Result

​Troubleshooting

​Next Steps

Tools Catalog

AI Agent Tutorial

Prerequisites

MCP Endpoint

Configuration Steps

Verify Configuration

Test Command

Expected Result

Troubleshooting

Next Steps