Skip to main content
Glama
REI Crypto MCP Server

REI Crypto MCP Server

by 0xReisearch

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

  • uv package manager

  • API keys for the services you plan to use

Installation

  1. Clone the repository:

git clone https://github.com/0xReisearch/crypto-mcp-beta
cd crypto-mcp-beta
  1. Install uv (if not already installed):

curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Create and activate a virtual environment with uv:

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
  1. Install dependencies from pyproject.toml:

uv pip install .
  1. Set up your environment variables:

cp .env_example .env

Edit .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.py

Configuring 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.json

  • macOS: ~/Library/Application Support/claude-desktop/claude_desktop_config.json

  • Linux: ~/.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/uv on Unix systems)

API Documentation

Feedback

If you encounter any issues or have suggestions for improvements:

  1. For bug reports or feature requests, please open an issue in this repository

  2. For general feedback or questions, you can leave a comment in the repository discussions

Made with ❤️ by Rei Network

Available Tools

61 tools
get_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

    B3.1/5.0

    Scored across 61 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with the CoinGecko Pro API to access cryptocurrency data including price history and market metrics through both MCP and OpenAI function calling.
      9
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Eight 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.
      8
      107 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides cryptographically verifiable RWA trust attestations and multi-chain DeFi data (TVL, top protocols, positioning scorecards) via MCP tools for AI assistants.
      11
      1
      MIT