REI Crypto MCP Server
REI Crypto MCP サーバー - ベータ版
Reiネットワークの各ユニットが使用する社内MCPサーバーのFastMCP実装。app.reisearch.boxでAPIキーを提供せずに使用することも、他のMCPクライアントで独自にデプロイして使用することもできます。
すべてはまだベータ版です。予告なく機能の追加や変更が行われる可能性があります。
現在の MCP サーバー:
DefiLlama Pro API
CoinGecko プロ API
アーカム・インテリジェンスAPI
エルファ AI API
コーデックス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-betauv をインストールします (まだインストールされていない場合)。
curl -LsSf https://astral.sh/uv/install.sh | shuv を使用して仮想環境を作成し、アクティブ化します。
uv venv
source .venv/bin/activate # On Unix/macOS
# or
.venv\Scripts\activate # On Windowspyproject.toml から依存関係をインストールします。
uv pip install .環境変数を設定します。
cp .env_example .envAPI キーを使用して.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.pyClaudeデスクトップの設定
これらのサーバーを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 ドキュメント- API アクセスについては、Elfa に直接お問い合わせください。
Arkham Intelligence - API アクセスについては、Arkham に直接問い合わせる必要があります。
フィードバック
問題が発生した場合や改善の提案がある場合は、次の手順に従ってください。
バグ報告や機能リクエストについては、このリポジトリで問題を開いてください。
一般的なフィードバックや質問については、リポジトリのディスカッションにコメントを残すことができます。
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.
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