MCP Setup Guide

Complete ChainStream MCP Server setup in 5 minutes

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

1. Get API Key

   1. Log in to ChainStream Dashboard
   2. Navigate to Applications
   3. Click Create New App and copy your API Key
2. Configure AI Client

   Claude Desktop

   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.

   Cursor IDE

   Config file path: .cursor/mcp.json (project-level) or Cursor Settings → Features → MCP Servers

   Option 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"
         }
       }
     }
   }
   

   Custom Client

   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));
   
3. 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:

1. Call tokens_search to find the SOL token
2. Call tokens_analyze to get security and holder data
3. 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:

1. API Key entered incorrectly
   • Check for extra spaces
   • Confirm complete copy
2. API Key revoked or expired
   • Check key status in Dashboard
   • Create a new key if needed
3. 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:

1. Network issues
   • Check network connection
   • Confirm access to https://mcp.chainstream.io
2. 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:

1. Config file path incorrect
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. JSON format error
   • Use a JSON validator to check
3. 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:

1. Plan quota exhausted
2. 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:

1. Network latency
2. 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