REI Crypto MCP Server
The REI Crypto MCP Server provides an interface to access comprehensive crypto-related APIs for data analysis across multiple sectors:
DeFi Data: Access TVL, protocol details, historical liquidity, emissions, token breakdowns, and categories
Stablecoins: Retrieve dominance metrics, circulating amounts, historical market cap, and chain distributions
Yields: Get yield pools, historical APY, borrow costs, perpetuals funding rates, and LSD rates
Bridges: View bridge volumes, transactions, summaries, and daily statistics
Derivatives: Query volumes, summaries, and historical data for derivative protocols
Prices: Fetch current and historical token prices, charts, and percentage changes
DEX: Analyze volumes and historical data for decentralized exchanges and options protocols
ETFs: Access metrics, historical AUM, and overviews for BTC and ETH ETFs
Protocol Fees: Get summaries of protocol fees and revenue with historical data
User Data: Retrieve active users and user-specific data by protocol
Miscellaneous: Access data for oracles, hacks, raises, treasuries, entities, and blockchain blocks
Handles environment variable management for storing API keys for the various crypto services.
Provides access to the in-house MCP servers used by Units of the Rei Network through a GitHub repository.
Used by the Codex API integration for its query system, allowing for contract address searches and parameter filtering.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@REI Crypto MCP Server get Bitcoin price and market cap from CoinGecko"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
REI Crypto MCP Server - Beta
FastMCP implementation of the in-house MCP servers used by Units of the Rei Network. You can use them without providing API keys at app.reisearch.box or you can use them with other MCP clients deploying them yourself.
Everything is to be considered still in beta. Expect things to be added or changed with no warnings.
Current MCP servers:
DefiLlama Pro API
CoinGecko Pro API
Arkham Intelligence API
Elfa AI API
Codex API
Codex at the moment is just used for searching a contract address from the name. Deeper implementation will come in the near future. Codex uses GraphQL for it's query system. Edit the query to hardcode some parameters in case you need stricter filtering.
Related MCP server: x402-api
Prerequisites
Python 3.12
uvpackage managerAPI keys for the services you plan to use
Installation
Clone the repository:
git clone https://github.com/0xReisearch/crypto-mcp-beta
cd crypto-mcp-betaInstall uv (if not already installed):
curl -LsSf https://astral.sh/uv/install.sh | shCreate and activate a virtual environment with uv:
uv venv
source .venv/bin/activate # On Unix/macOS
# or
.venv\Scripts\activate # On WindowsInstall dependencies from pyproject.toml:
uv pip install .Set up your environment variables:
cp .env_example .envEdit .env with your API keys:
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>Running the Servers
You can run each server individually:
# 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.pyConfiguring Claude Desktop
To use these servers with Claude Desktop, you need to configure the claude_desktop_config.json file. This file is typically located in:
Windows:
%APPDATA%/claude-desktop/claude_desktop_config.jsonmacOS:
~/Library/Application Support/claude-desktop/claude_desktop_config.jsonLinux:
~/.config/claude-desktop/claude_desktop_config.json
Example configuration:
{
"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"
]
}
}
}Replace the following:
user@your-host: Your SSH username and host/path/to/crypto_mcp: The absolute path to where you cloned this repository/path/to/uv: The absolute path to your uv installation (usually in~/.local/bin/uvon Unix systems)
API Documentation
Elfa AI Api Documentation - Contact Elfa directly for api access.
Arkham Intelligence - You need to contact Arkham directly for api access.
Feedback
If you encounter any issues or have suggestions for improvements:
For bug reports or feature requests, please open an issue in this repository
For general feedback or questions, you can leave a comment in the repository discussions
Made with ❤️ by 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