Tutorials & Integrations
Claude Crypto Integration
Claude can answer live crypto questions when it is connected to a current data source. This guide connects Claude to Hive Intelligence through the managed remote MCP endpoint at https://mcp.hiveintelligence.xyz/mcp. Claude uses that connection to discover Hive tools, inspect schemas, and call provider-backed market, DeFi, wallet, and token-risk data.
What Claude will be able to do
By the end of this guide, Claude will answer questions like these with live data:
- "What is the current price of Solana and how has it moved in the last 24 hours?"
- "Show me the top five DeFi protocols by TVL this week."
- "Is the token at
0x6982508145454Ce325dDbE47a25d4ec3d2311933safe to interact with?" - "What are the balances in the wallet
0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?" - "Which prediction markets on Polymarket have the largest open interest right now?"
All of this comes from one MCP connection. Claude discovers the available tools at runtime, so new providers or tools are exposed through runtime schemas instead of hand-written static wrappers.
Prerequisites
- Claude Desktop, Claude Code, or another Claude-facing client that supports Streamable HTTP with API-key headers or the local stdio wrapper.
- A Hive API key from the dashboard.
- A client-specific config path and your Hive API key.
Step 1: Create a Hive API key
- Go to hiveintelligence.xyz/dashboard.
- Sign up or sign in.
- Open API Keys and click Create key.
- Store the key securely; you will add it to the selected Claude setup path in the next step.
See Pricing for current monthly credits, rate limits, and plan details.
Step 2: Connect Claude to Hive
Pick the Claude surface you use.
Option A: Claude Code (CLI)
Run this command in your terminal:
claude mcp add --transport http hive "https://mcp.hiveintelligence.xyz/mcp" \
--header "Authorization: Bearer YOUR_HIVE_API_KEY"Replace YOUR_HIVE_API_KEY with the key from Step 1. Claude Code prints a confirmation line. The tools are available the next time you open a session. For the full flag reference (scopes, Bearer-token auth, stdio alternative), see the dedicated Claude Code install page.
Option B: Claude Desktop
Claude Desktop adds remote MCP servers through the Custom Connectors UI, not through claude_desktop_config.json (which is stdio-only). In Claude Desktop:
- Settings → Connectors in the sidebar.
- Hover Add custom, click Web.
- Set Name to
Hive, URL tohttps://mcp.hiveintelligence.xyz/mcp, Authentication to Bearer token, and enter your Hive API key. - Click Add. Claude validates the connection and lists Hive's tools.
Available on Free (one connector), Pro, Max, Team, and Enterprise plans. For an air-gapped or proxy-only setup, the dedicated Claude Desktop install page covers the stdio fallback that does go through claude_desktop_config.json.
Option C: Claude API with a third-party MCP client
If you are calling the Claude API directly (not through a desktop client), use an MCP-over-HTTP bridge that lets you send authorization headers. The MCP TypeScript SDK and MCP Python SDK are compatible choices. Point the client at https://mcp.hiveintelligence.xyz/mcp and pass an Authorization: Bearer header. The raw JSON-RPC shape is:
curl -X POST https://mcp.hiveintelligence.xyz/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer YOUR_HIVE_API_KEY" \
-d '{
"jsonrpc": "2.0",
"method": "tools/list",
"id": 1
}'Step 3: Verify the connection
- Claude Code: run
/mcpinside any session. You should seehivewith a tool count. - Claude Desktop: click the tools icon.
hiveshould appear as a connected server.
If hive is missing, jump to Troubleshooting below.
Step 4: Ask Claude a live-data question
Try each of these prompts. Each one exercises a different Hive tool category.
Price check
What is the current price of Bitcoin and Ethereum?
Claude calls get_price (CoinGecko). You should see current USD prices with freshness metadata.
DeFi overview
Show me the top five DeFi protocols by TVL.
Claude calls get_defi_protocols (DeFiLlama). Expect a ranked list with TVL, 24-hour change, and chain breakdown.
Token risk check
Check the token at
0x6982508145454Ce325dDbE47a25d4ec3d2311933for honeypot risk, owner privileges, and tax flags. Return pass, block, or escalate with the evidence used.
Claude calls get_token_security (GoPlus). That address is PEPE, a real token. Claude reports the risk evidence: honeypot status, buy/sell tax, ownership privileges, and proxy contract flags.
Wallet inspection
What are the token balances in
0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?
Claude calls alchemy_get_token_balances_by_wallet. That address is vitalik.eth, publicly known and safe to probe.
Prediction markets
Which prediction markets on Polymarket have the largest open interest right now?
Claude calls get_polymarket_markets (Codex). Expect a ranked list of active markets with dollar volume.
Step 5: Switch to a category endpoint for focused agents
The root /mcp endpoint exposes the compact discovery and routing layer, which suits general-purpose Claude agents that may reach into any domain. If you are building a focused agent (a trading bot, for example) and only need one category, point at a narrower endpoint so Claude has a smaller direct tool list to reason over.
| Category | Endpoint |
|---|---|
| Market data | /hive_market_data/mcp |
| DeFi protocols | /hive_defi_protocol/mcp |
| DEX analytics | /hive_onchain_dex/mcp |
| Security & risk | /hive_security_risk/mcp |
| Portfolio & wallet | /hive_portfolio_wallet/mcp |
| Prediction markets | /hive_prediction_markets/mcp |
Claude Desktop can connect to multiple category endpoints at once. A "market + security" agent, for example:
{
"mcpServers": {
"hive-market": {
"url": "https://mcp.hiveintelligence.xyz/hive_market_data/mcp",
"headers": { "Authorization": "Bearer YOUR_HIVE_API_KEY" }
},
"hive-security": {
"url": "https://mcp.hiveintelligence.xyz/hive_security_risk/mcp",
"headers": { "Authorization": "Bearer YOUR_HIVE_API_KEY" }
}
}
}See the full list on the Crypto MCP Server page.
Troubleshooting
"Invalid API key" or 401 responses
- Copy the key exactly from the dashboard. Trailing spaces and stray newlines are the most common culprit.
- Confirm you are using the
Authorization: Bearer YOUR_KEYheader.x-api-key: YOUR_KEYis also accepted, but don't send both at once.
Claude doesn't see Hive after a restart
- Double-check the config file path (macOS vs. Windows paths differ).
- Validate the JSON. A missing comma silently prevents Claude from loading the server list.
- In Claude Code, run
claude mcp listto confirm the server was added.
429 rate limit responses
- Respect the
Retry-Afterheader before retrying. - Check current usage and plan limits in the dashboard, then review Rate Limits and Pricing before increasing traffic.
- If you are polling prices, cache for 30 seconds on your side. Hive already deduplicates upstream calls, but local cache saves credits.
"Tool not found" errors
- Tool names use
snake_case(for exampleget_price, notgetPrice). - If you connected to a category endpoint, only that category's tools are visible. Switch to
/mcpfor the full catalog. - Runtime discovery: ask Claude "list all available Hive tools" and it will call
tools/list.
Related
- Crypto MCP Server: endpoint reference and category list
- API Integration: REST, MCP, and discovery surfaces
- Tools Reference: browse every tool with input schemas
- Playground: try tools in the browser before wiring up Claude
- Pricing: credits, rate limits, and plan comparison