Arkham MCP Server

MCP (Model Context Protocol) server for the Arkham Intel API — blockchain intelligence via SSE/Express transport.

Transport: SSE (Server-Sent Events)
Stack: TypeScript, Express, @modelcontextprotocol/sdk
Tools: 80+ tools covering every Arkham API endpoint

Setup

npm install
cp .env.example .env
# Add your ARKHAM_API_KEY to .env

Run

# Development (ts-node, hot reload)
npm run dev

# Production
npm run build && npm start

Server starts on http://localhost:3000 (configurable via PORT env var).

Endpoints

Method	Path	Description
GET	/sse	SSE stream — connect MCP client here
POST	/messages?sessionId=...	JSON-RPC message endpoint
GET	/health	Health check

MCP Client Configuration

{
  "mcpServers": {
    "arkham": {
      "url": "http://localhost:3000/sse"
    }
  }
}

Environment Variables

Variable	Required	Description
ARKHAM_API_KEY	Yes	API key from intel.arkm.com/settings
PORT	No	Server port (default: 3000)

Tools

The server exposes 80+ MCP tools grouped by category:

Intelligence

• get_address_intelligence — Address labels, entity attribution
• get_address_intelligence_all — All chains
• get_address_enriched — With tags, clusters, predictions
• get_address_enriched_all — All chains enriched
• batch_address_intelligence — Batch lookup
• batch_address_intelligence_all — Batch all chains
• batch_address_enriched / batch_address_enriched_all
• get_entity_intelligence — Entity labels and metadata
• get_entity_summary — Entity stats
• get_entity_predictions — Predicted address attributions
• get_contract_intelligence — Smart contract info
• get_token_intelligence_by_id / get_token_intelligence_by_chain
• search_intelligence — Search addresses, entities, tokens
• get_entity_types — All entity categories
• get_entity_balance_changes
• get_address_intelligence_updates / get_entity_intelligence_updates
• get_tags_updates / get_address_tags_updates

Transfers & Swaps

• get_transfers — Filtered on-chain transfers
• get_transfers_by_tx — Transfers in a transaction
• get_transfers_histogram / get_transfers_histogram_simple
• get_swaps — DEX swap events
• get_transaction — Full tx details

Balances

• get_address_balances / get_entity_balances
• get_solana_subaccount_balances_by_address / ..._by_entity

Portfolio

• get_address_portfolio / get_entity_portfolio
• get_address_portfolio_time_series / get_entity_portfolio_time_series

History

• get_address_history / get_entity_history

Counterparties & Flow

• get_address_counterparties / get_entity_counterparties
• get_address_flow / get_entity_flow
• get_address_volume / get_entity_volume

Loans

• get_address_loans / get_entity_loans

Tokens

• get_top_tokens / get_trending_tokens / get_trending_token_by_id
• get_token_holders_by_id / get_token_holders_by_chain
• get_token_top_flow_by_id / get_token_top_flow_by_chain
• get_token_volume_by_id / get_token_volume_by_chain
• get_token_balance_by_id / get_token_balance_by_chain
• get_token_market / get_token_price_history_by_id / ..._by_chain
• get_token_price_change / get_token_addresses
• get_arkham_exchange_tokens

Tags, Clusters & Labels

• get_tag_params / get_tag_summary
• get_cluster_summary
• get_user_labels / create_user_labels
• get_user_entities / get_user_entity_by_id / update_user_entity

Market Data & Networks

• get_altcoin_index / get_networks_status / get_network_history
• get_chains / get_arkm_circulating

WebSocket Sessions

• get_ws_sessions / create_ws_session
• get_ws_session_by_id / delete_ws_session
• get_ws_session_info / get_ws_active_connections

API Reference

Full endpoint docs: intel.arkm.com/llms-full.txt