REI Crypto MCP Server
REI Crypto MCP 服务器 - 测试版
Rei Network 各单位使用的内部 MCP 服务器的 FastMCP 实现。您可以在 app.reisearch.box 上直接使用它们,无需提供 API 密钥,也可以与其他自行部署的 MCP 客户端一起使用。
所有功能都处于测试阶段。预计会在没有任何预警的情况下添加或更改内容。
当前 MCP 服务器:
DefiLlama Pro API
CoinGecko Pro API
阿卡姆情报 API
艾尔法人工智能 API
Codex API
Codex 目前仅用于根据名称搜索合约地址。更深入的实现将在不久的将来推出。Codex 使用 GraphQL 作为其查询系统。如果您需要更严格的过滤,请编辑查询以硬编码某些参数。
Related MCP server: x402-api
先决条件
Python 3.12
uv包管理器您计划使用的服务的 API 密钥
安装
克隆存储库:
git clone https://github.com/0xReisearch/crypto-mcp-beta
cd crypto-mcp-beta安装 uv(如果尚未安装):
curl -LsSf https://astral.sh/uv/install.sh | sh使用 uv 创建并激活虚拟环境:
uv venv
source .venv/bin/activate # On Unix/macOS
# or
.venv\Scripts\activate # On Windows从 pyproject.toml 安装依赖项:
uv pip install .设置环境变量:
cp .env_example .env使用您的 API 密钥编辑.env :
ARKHAM_API_KEY=<YOUR ARKHAM_API_KEY>
CG_API_KEY=<YOUR_CG_API_KEY>
DEFILLAMA_API_KEY=<YOUR_DEFILLAMA_API_KEY>
CODEX_API_KEY=<YOUR_CODEX_API_KEY>
ELFA_API_KEY=<YOUR_ELFA_API_KEY>运行服务器
您可以单独运行每个服务器:
# Run DefiLlama server
uv run defillama_server.py
# Run CoinGecko server
uv run cg_server.py
# Run Arkham server
uv run arkham_server.py
# Run Codex server
uv run codex_server.py
# Run Elfa AI server
uv run elfa_server.py配置 Claude 桌面
要将这些服务器与 Claude Desktop 一起使用,您需要配置claude_desktop_config.json文件。此文件通常位于:
Windows:
%APPDATA%/claude-desktop/claude_desktop_config.jsonmacOS:
~/Library/Application Support/claude-desktop/claude_desktop_config.jsonLinux:
~/.config/claude-desktop/claude_desktop_config.json
示例配置:
{
"mcpServers": {
"arkham": {
"command": "ssh",
"args": [
"user@your-host",
"cd /path/to/crypto_mcp && /path/to/uv run arkham_server.py"
]
},
"coingecko": {
"command": "ssh",
"args": [
"user@your-host",
"cd /path/to/crypto_mcp && /path/to/uv run cg_server.py"
]
},
"defillama": {
"command": "ssh",
"args": [
"user@your-host",
"cd /path/to/crypto_mcp && /path/to/uv run defillama_server.py"
]
},
"codex": {
"command": "ssh",
"args": [
"user@your-host",
"cd /path/to/crypto_mcp && /path/to/uv run codex_server.py"
]
},
"elfa": {
"command": "ssh",
"args": [
"user@your-host",
"cd /path/to/crypto_mcp && /path/to/uv run elfa_server.py"
]
}
}
}替换以下内容:
user@your-host:您的 SSH 用户名和主机/path/to/crypto_mcp:克隆此存储库的绝对路径/path/to/uv:uv 安装的绝对路径(在 Unix 系统上通常位于~/.local/bin/uv中)
API 文档
Elfa AI Api 文档- 直接联系 Elfa 进行 api 访问。
Arkham Intelligence - 您需要直接联系 Arkham 以获取 API 访问权限。
反馈
如果您遇到任何问题或有改进建议:
对于错误报告或功能请求,请在此存储库中打开一个问题
对于一般反馈或问题,您可以在存储库讨论中发表评论
由Rei Network倾情打造
Available Tools
61 toolsget_active_usersB
GET /api/activeUsers
Get active users on our chains and protocols pages.
Inputs: no named parameters. Returns: result
get_batch_historical_pricesB
GET /coins/batchHistorical
Get historical prices for multiple tokens at multiple different timestamps.
Parameters:
coins: dict where keys are coins in format {chain}:{address} and values are arrays of timestamps
search_width: time range on either side to find price data (default: '6h')
Inputs: coins (required), search_width. Returns: result
get_bridge_day_statsC
GET /bridgedaystats/{timestamp}/{chain}
Get a 24hr token and address volume breakdown for a bridge.
Parameters:
timestamp: Unix timestamp for the 24hr period starting at 00:00 UTC
chain: chain slug (e.g., 'Ethereum')
id: bridge ID (optional, can be retrieved from /bridges)
Inputs: timestamp (required), chain (required), id. Returns: result
get_bridge_detailsB
GET /bridge/{id}
Get summary of bridge volume and volume breakdown by chain.
Parameters:
id: bridge ID (can be retrieved from /bridges)
Inputs: id (required). Returns: result
get_bridgesB
GET /bridges
List all bridges along with summaries of recent bridge volumes.
Parameters:
include_chains: set whether to include current previous day volume breakdown by chain
Inputs: include_chains. Returns: result
get_bridge_transactionsB
GET /transactions/{id}
Get all transactions for a bridge within a date range.
Parameters:
id: bridge ID (can be retrieved from /bridges)
start_timestamp: start timestamp (Unix Timestamp) for date range
end_timestamp: end timestamp (Unix Timestamp) for date range
source_chain: filter by source chain (e.g., 'Polygon')
address: filter by address in format {chain}:{address}
limit: limit number of transactions returned (max 6000)
Inputs: id (required), start_timestamp, end_timestamp, source_chain, +2 more. Returns: result
get_bridge_volumeB
GET /bridgevolume/{chain}
Get historical volumes for a bridge, chain, or bridge on a particular chain.
Parameters:
chain: chain slug (e.g., 'Ethereum') or 'all' for volume on all chains
id: bridge ID (optional, can be retrieved from /bridges)
Inputs: chain (required), id. Returns: result
get_categoriesB
GET /api/categories
Overview of all categories across all protocols.
Inputs: no named parameters. Returns: result
get_chain_assetsB
GET /api/chainAssets
Get assets of all chains.
Inputs: no named parameters. Returns: result
get_chainsB
GET /api/v2/chains
Get current TVL of all chains.
Inputs: no named parameters. Returns: result
get_closest_blockC
GET /coins/block/{chain}/{timestamp}
Get the closest block to a timestamp.
Parameters:
chain: chain identifier
timestamp: UNIX timestamp to find closest block for
Inputs: chain (required), timestamp (required). Returns: result
get_current_pricesB
GET /coins/prices/current/{coins}
Get current prices of tokens by contract address.
Parameters:
coins: comma-separated tokens in format {chain}:{address} (e.g., 'ethereum:0xdF574c24545E5FfEcb9a659c229253D4111d87e1,coingecko:ethereum')
search_width: time range on either side to find price data (default: '6h')
Inputs: coins (required), search_width. Returns: result
get_derivatives_overviewB
GET /api/overview/derivatives
Lists all derivatives along summaries of their volumes filtering by chain.
Parameters:
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response
Inputs: exclude_total_data_chart, exclude_total_data_chart_breakdown. Returns: result
get_derivatives_summaryB
GET /api/summary/derivatives/{protocol}
Volume Details about a specific perp protocol.
Parameters:
protocol: protocol slug (e.g., 'hyperliquid')
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response
Inputs: protocol (required), exclude_total_data_chart, exclude_total_data_chart_breakdown. Returns: result
get_dex_overviewB
GET /api/overview/dexs
List all dexs along with summaries of their volumes and dataType history data.
Parameters:
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response
Inputs: exclude_total_data_chart, exclude_total_data_chart_breakdown. Returns: result
get_dex_overview_by_chainB
GET /api/overview/dexs/{chain}
List all dexs along with summaries of their volumes and dataType history data filtering by chain.
Parameters:
chain: chain name (e.g., 'ethereum')
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response
Inputs: chain (required), exclude_total_data_chart, exclude_total_data_chart_breakdown. Returns: result
get_dex_summaryB
GET /api/summary/dexs/{protocol}
Get summary of dex volume with historical data.
Parameters:
protocol: protocol slug (e.g., 'uniswap')
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response
Inputs: protocol (required), exclude_total_data_chart, exclude_total_data_chart_breakdown. Returns: result
get_emission_dataC
GET /api/emission/{protocol}
Unlocks data for a given token/protocol.
Parameters:
protocol: protocol slug (e.g., 'aave')
Inputs: protocol (required). Returns: result
get_emissionsB
GET /api/emissions
List of all tokens along with basic info for each.
Inputs: no named parameters. Returns: result
get_entitiesC
GET /api/entities
List all entities.
Inputs: no named parameters. Returns: result
get_etf_historyB
GET /etfs/history
Historical AUM of all BTC ETFs.
Inputs: no named parameters. Returns: result
get_etf_history_ethB
GET /etfs/historyEth
Historical AUM of all ETH ETFs.
Inputs: no named parameters. Returns: result
get_etf_overviewB
GET /etfs/overview
Get BTC ETFs and their metrics (aum, price, fees...).
Inputs: no named parameters. Returns: result
get_etf_overview_ethC
GET /etfs/overviewEth
Get ETH ETFs.
Inputs: no named parameters. Returns: result
get_fdv_performanceC
GET /fdv/performance/{period}
Get chart of narratives based on category performance (with individual coins weighted by mcap).
Parameters:
period: One of ['7', '30', 'ytd', '365']
Inputs: period (required). Returns: result
get_fees_summaryB
GET /api/summary/fees/{protocol}
Get summary of protocol fees and revenue with historical data.
Parameters:
protocol: protocol slug (e.g., 'lyra')
data_type: desired data type (default: 'dailyFees')
Inputs: protocol (required), data_type. Returns: result
get_first_price_recordB
GET /coins/prices/first/{coins}
Get earliest timestamp price record for coins.
Parameters:
coins: comma-separated tokens in format {chain}:{address}
Inputs: coins (required). Returns: result
get_forksB
GET /api/forks
Overview of all forks across all protocols.
Inputs: no named parameters. Returns: result
get_hacksB
GET /api/hacks
Overview of all hacks on our Hacks dashboard.
Inputs: no named parameters. Returns: result
get_historical_chain_tvlB
GET /api/v2/historicalChainTvl
Get historical TVL (excludes liquid staking and double counted tvl) of DeFi on all chains.
Inputs: no named parameters. Returns: result
get_historical_chain_tvl_by_chainC
GET /api/v2/historicalChainTvl/{chain}
Get historical TVL (excludes liquid staking and double counted tvl) of a chain.
Parameters:
chain: chain slug (e.g., 'Ethereum')
Inputs: chain (required). Returns: result
get_historical_liquidityC
GET /api/historicalLiquidity/{token}
Provides the available liquidity for swapping from one token to another on a specific chain.
Parameters:
token: token slug (e.g., 'usdt')
Inputs: token (required). Returns: result
get_historical_pricesB
GET /coins/prices/historical/{timestamp}/{coins}
Get historical prices of tokens by contract address.
Parameters:
timestamp: UNIX timestamp for historical prices
coins: comma-separated tokens in format {chain}:{address}
search_width: time range on either side to find price data (default: '6h')
Inputs: timestamp (required), coins (required), search_width. Returns: result
get_options_overviewB
GET /api/overview/options
List all options dexs along with summaries of their volumes and dataType history data.
Parameters:
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response
data_type: desired data type (default: 'dailyNotionalVolume')
Inputs: exclude_total_data_chart, exclude_total_data_chart_breakdown, data_type. Returns: result
get_options_overview_by_chainB
GET /api/overview/options/{chain}
List all options dexs along with summaries of their volumes and dataType history data filtering by chain.
Parameters:
chain: chain name (e.g., 'ethereum')
exclude_total_data_chart: true to exclude aggregated chart from response
exclude_total_data_chart_breakdown: true to exclude broken down chart from response
data_type: desired data type (default: 'dailyNotionalVolume')
Inputs: chain (required), exclude_total_data_chart, exclude_total_data_chart_breakdown, data_type. Returns: result
get_options_summaryC
GET /api/summary/options/{protocol}
Get summary of options dex volume with historical data.
Parameters:
protocol: protocol slug (e.g., 'lyra')
data_type: desired data type (default: 'dailyNotionalVolume')
Inputs: protocol (required), data_type. Returns: result
get_oraclesB
GET /api/oracles
Overview of all oracles across all protocols.
Inputs: no named parameters. Returns: result
get_price_chartB
GET /coins/chart/{coins}
Get token prices at regular time intervals.
Parameters:
coins: comma-separated tokens in format {chain}:{address}
start: unix timestamp of earliest data point
end: unix timestamp of latest data point
span: number of data points returned
period: duration between data points (default: '24h')
search_width: time range on either side to find price data (default: '600')
Inputs: coins (required), start, end, span, +2 more. Returns: result
get_price_percentageB
GET /coins/percentage/{coins}
Get percentage change in price over time.
Parameters:
coins: comma-separated tokens in format {chain}:{address}
timestamp: timestamp of data point (defaults to now)
look_forward: whether to look forward from timestamp (default: False)
period: duration between data points (default: '24h')
Inputs: coins (required), timestamp, look_forward, period. Returns: result
get_protocol_detailsB
GET /api/protocol/{protocol}
Get historical TVL of a protocol and breakdowns by token and chain.
Parameters:
protocol: protocol slug (e.g., 'aave')
Inputs: protocol (required). Returns: result
get_protocol_inflowsB
GET /api/inflows/{protocol}/{timestamp}
Lists the amount of inflows and outflows for a protocol at a given date.
Parameters:
protocol: protocol slug (e.g., 'compound-v3')
timestamp: unix timestamp (e.g., 1700006400)
Inputs: protocol (required), timestamp (required). Returns: result
get_protocolsB
GET /api/protocols
List all protocols on defillama along with their tvl.
Inputs: no named parameters. Returns: result
get_protocol_tvlB
GET /api/tvl/{protocol}
Simplified endpoint to get current TVL of a protocol.
Parameters:
protocol: protocol slug (e.g., 'uniswap')
Inputs: protocol (required). Returns: result
get_raisesC
GET /api/raises
Overview of all raises on our Raises dashboard.
Inputs: no named parameters. Returns: result
get_stablecoin_chainsB
GET /stablecoins/stablecoinchains
Get current mcap sum of all stablecoins on each chain.
Inputs: no named parameters. Returns: result
get_stablecoin_charts_allC
GET /stablecoins/stablecoincharts/all
Get historical mcap sum of all stablecoins.
Parameters:
stablecoin: stablecoin ID (optional)
Inputs: stablecoin. Returns: result
get_stablecoin_charts_by_chainC
GET /stablecoins/stablecoincharts/{chain}
Get historical mcap sum of all stablecoins in a chain.
Parameters:
chain: chain slug (e.g., 'Ethereum')
stablecoin: stablecoin ID (optional)
Inputs: chain (required), stablecoin. Returns: result
get_stablecoin_dominanceC
GET /stablecoins/stablecoindominance/{chain}
Get stablecoin dominance per chain along with the info about the largest coin in a chain.
Parameters:
chain: chain slug (e.g., 'Ethereum')
stablecoin: stablecoin ID (optional)
Inputs: chain (required), stablecoin. Returns: result
get_stablecoin_historyC
GET /stablecoins/stablecoin/{asset}
Get historical mcap and historical chain distribution of a stablecoin.
Parameters:
asset: stablecoin ID
Inputs: asset (required). Returns: result
get_stablecoin_pricesB
GET /stablecoins/stablecoinprices
Get historical prices of all stablecoins.
Inputs: no named parameters. Returns: result
get_stablecoinsB
GET /stablecoins/stablecoins
List all stablecoins along with their circulating amounts.
Parameters:
include_prices: whether to include current stablecoin prices (default: True)
Inputs: include_prices. Returns: result
get_token_protocolsB
GET /api/tokenProtocols/{symbol}
Lists the amount of a certain token within all protocols.
Parameters:
symbol: token slug (e.g., 'usdt')
Inputs: symbol (required). Returns: result
get_treasuriesB
GET /api/treasuries
List all protocols on our Treasuries dashboard.
Inputs: no named parameters. Returns: result
get_user_dataC
GET /api/userData/{type}/{protocolId}
Get user data by type and protocol.
Parameters:
type: data type (e.g., 'activeUsers')
protocol_id: protocol ID
Inputs: type (required), protocol_id (required). Returns: result
get_yield_chartB
GET /yields/chart/{pool}
Get historical APY and TVL of a pool.
Parameters:
pool: pool id (can be retrieved from /pools)
Inputs: pool (required). Returns: result
get_yield_chart_lend_borrowB
GET /yields/chartLendBorrow/{pool}
Historical borrow cost APY from a pool on a lending market.
Parameters:
pool: pool id (can be retrieved from /poolsBorrow)
Inputs: pool (required). Returns: result
get_yield_lsd_ratesB
GET /yields/lsdRates
APY rates of multiple LSDs.
Inputs: no named parameters. Returns: result
get_yield_perpsB
GET /yields/perps
Funding rates and Open Interest of perps across exchanges, including both Decentralized and Centralized.
Inputs: no named parameters. Returns: result
get_yield_poolsB
GET /yields/pools
Retrieve the latest data for all pools, including enriched information such as predictions.
Inputs: no named parameters. Returns: result
get_yield_pools_borrowB
GET /yields/poolsBorrow
Borrow costs APY of assets from lending markets.
Inputs: no named parameters. Returns: result
get_yield_pools_oldC
GET /yields/poolsOld
Same as /pools but it also includes a new parameter `pool_old` which usually contains pool address.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 61 tools
Tools are generally distinct by resource type (e.g., bridges, prices, protocols), but there is notable overlap in some areas. For example, multiple price-related tools (get_current_prices, get_historical_prices, get_price_chart, get_price_percentage) could cause confusion about which to use for specific price queries. Similarly, overview and summary tools for derivatives, dexs, and options have overlapping purposes that might require careful reading of descriptions to differentiate.
Tool names follow a highly consistent verb_noun pattern throughout, all starting with 'get_' followed by a descriptive noun phrase (e.g., get_bridge_details, get_historical_prices). There are no deviations in naming style, making it easy to predict tool names and understand their general purpose at a glance.
With 61 tools, the count is excessive for a single server, making it overwhelming and difficult for an agent to navigate efficiently. While the server covers a broad crypto domain (prices, bridges, protocols, yields, etc.), the toolset feels bloated and could benefit from consolidation or modularization into more focused servers.
The toolset provides extensive coverage across multiple crypto domains (e.g., prices, bridges, protocols, yields, stablecoins), with CRUD-like operations for many resources. However, there are minor gaps, such as limited update or delete operations (typical for read-heavy APIs) and some areas like user data or emissions lacking full lifecycle coverage, though agents can likely work around these given the breadth of read operations.
Maintenance
Related MCP Connectors
DefiLlama MCP — DeFi analytics from DefiLlama (free, no auth)
Cambrian API MCP: Solana and EVM DeFi data, Deep42 social intelligence, and perpetual risk analysis.
Crypto MCP with 21 tools for market data, DeFi, analytics, and sentiment. Post-paid USDC billing.
DefiLlama MCP — TVL, yields, volumes, fees, and protocol analytics for DeFi.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with the CoinGecko Pro API to access cryptocurrency data including price history and market metrics through both MCP and OpenAI function calling.9MIT
- AlicenseAqualityBmaintenanceEight crypto and DeFi data tools for AI agents: prices, gas, one ParaSwap route quote, GoPlus token security and top-holder samples, DefiLlama yields, Hyperliquid/dYdX funding, and observed wallet balances. Inspect prices free; pay 0.001–0.008 USDC per call on Base through x402. No API key or subscription.8107 npmMIT
- FlicenseNot gradedqualityDmaintenanceReal-time DeFi data for AI agents. Provides yields, TVL, prices, DEX volumes, fees, and contract data via 8 MCP endpoints, powered by DeFiLlama.-
- AlicenseAqualityDmaintenanceProvides cryptographically verifiable RWA trust attestations and multi-chain DeFi data (TVL, top protocols, positioning scorecards) via MCP tools for AI assistants.111MIT