Skip to main content
Glama
REI Crypto MCP Server

REI Crypto MCP Server

by 0xReisearch

Servidor MCP de REI Crypto - Beta

Implementación de FastMCP de los servidores MCP internos utilizados por las Unidades de la Red Rei. Puede usarlos sin proporcionar claves API en app.reisearch.box o con otros clientes MCP implementándolos usted mismo.

Todo debe considerarse aún en fase beta. Se espera que se añadan o modifiquen cosas sin previo aviso.

Servidores MCP actuales:

  • API de DefiLlama Pro

  • API de CoinGecko Pro

  • API de inteligencia de Arkham

  • API de inteligencia artificial de Elfa

  • API del Codex

Actualmente, Codex solo se utiliza para buscar direcciones de contratos a partir del nombre. Próximamente se implementará una versión más completa. Codex utiliza GraphQL para su sistema de consultas. Edite la consulta para codificar algunos parámetros si necesita un filtrado más estricto.

Related MCP server: x402-api

Prerrequisitos

  • Python 3.12

  • administrador de paquetes uv

  • Claves API para los servicios que planea utilizar

Instalación

  1. Clonar el repositorio:

git clone https://github.com/0xReisearch/crypto-mcp-beta
cd crypto-mcp-beta
  1. Instalar uv (si aún no está instalado):

curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Crear y activar un entorno virtual con uv:

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
  1. Instalar dependencias desde pyproject.toml:

uv pip install .
  1. Configure sus variables de entorno:

cp .env_example .env

Edite .env con sus claves API:

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>

Ejecución de los servidores

Puede ejecutar cada servidor individualmente:

# 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

Configuración de Claude Desktop

Para usar estos servidores con Claude Desktop, debe configurar el archivo claude_desktop_config.json . Este archivo suele estar en:

  • Ventanas: %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

Ejemplo de configuración:

{
    "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"
            ]
        }
    }
}

Reemplace lo siguiente:

  • user@your-host : Su nombre de usuario y host SSH

  • /path/to/crypto_mcp : La ruta absoluta a donde clonó este repositorio

  • /path/to/uv : La ruta absoluta a su instalación uv (generalmente en ~/.local/bin/uv en sistemas Unix)

Documentación de la API

Comentario

Si encuentra algún problema o tiene sugerencias para mejorar:

  1. Para informes de errores o solicitudes de funciones, abra un problema en este repositorio.

  2. Para comentarios o preguntas generales, puede dejar un comentario en las discusiones del repositorio.

Hecho con ❤️ por 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