Для чего этот сервер?

Этот сервер соединяет ИИ-ассистентов с блокчейн-данными Codex. Он нужен, чтобы нейросеть могла прямо в диалоге отвечать на вопросы о транзакциях, балансах и блоках. Разработчику не нужно писать отдельные запросы к API — сервер сам подгружает нужную информацию по запросу ассистента.

Что он умеет?

Сервер работает с блокчейн-данными: получает список сетей, их статус и статистику, читает информацию о токенах, фильтрует их по разным критериям, отслеживает события и транзакции, цены, строит графики изменения цены, находит последние развернутые контракты. По парам ищет по объему, цене, ликвидности, получает метаданные, историческую статистику, пары для токена. Умеет получать держателей токена и их долю топ-10, балансы кошелька, события по кошельку, метаданные и локауты ликвидности, ищет биржи по активности.

Каталог MCP
codex-data/codex-mcp

codex-data/codex-mcp

от codex-data

MCP-сервер для доступа к обогащенным данным блокчейна через Codex API. Работает с Claude Desktop и любыми MCP-клиентами - получайте аналитику по транзакциям, кошелькам и метрикам.

Github NPM Сайт сервера

README

25 инструментов

Версии

Установить сервер

Codex MCP Server

An MCP server that provides enriched blockchain data from Codex. This server can be used with any MCP-compatible client like Claude Desktop.

Installation

# Clone the repository
git clone https://github.com/codex-data/codex-mcp.git
cd codex-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

Usage

To use the MCP Codex Server, you need to have a Codex API key. You can get your key from the Codex Dashboard.

Using npx (No Installation Required)

You can run the MCP Codex Server directly without installation using npx:

# Run the server in stdio mode (for CLI tools)
npx @codex-data/codex-mcp

Running the Server Locally

Start the server using stdio (for embedding in CLI tools):

pnpm start

For development with auto-reload:

pnpm dev

Integration with Claude Desktop

Open Claude Desktop settings
Go to the Developer tab and click "Edit Config"
Add a new server configuration:

No installation:

{
  "mcpServers": {
    "codex-data": {
      "command": "npx",
      "args": ["-y", "@codex-data/codex-mcp"],
      "env": {
        "CODEX_API_KEY": "<your-codex-api-key>"
      }
    }
  }
}

Часто задаваемые вопросы

Инструменты были проиндексированы: 18.10.2026

filter_exchanges

Получить список бирж по различным фильтрам: объём, транзакции, активные пользователи и т.д.

Параметры

filtersobject
limitnumber
Максимальное количество возвращаемых элементов
offsetnumber
phrasestring
Фраза для поиска. Может совпадать с адресом биржи или ID (address:networkId), а также частично совпадать с названием биржи.
rankingsobject[]
Список атрибутов ранжирования, которые нужно применить.

filter_pairs

Получает список пар на основе различных фильтров: объём, цена, ликвидность и другие.

Параметры

filtersobject
limitnumber
Максимальное количество возвращаемых элементов
offsetnumber
pairsstring[] | string
phrasestring
rankingsobject[] | object
statsTypeenum
Тип возвращаемой статистики. Может быть FILTERED или UNFILTERED.

filter_tokens

Фильтрует токены по различным критериям.

Параметры

excludeTokensstring[]
Список идентификаторов токенов, которые нужно исключить из результатов (address:networkId)
filtersobject
Набор фильтров для применения
limitnumber
Максимальное количество возвращаемых элементов
offsetnumber
phrasestring
Фраза для поиска. Может совпадать с адресом контракта токена или частично совпадать с названием или символом токена.
rankingsobject[]
Список атрибутов ранжирования, которые нужно применить.
statsTypeenum
Тип возвращаемой статистики. Может быть FILTERED или UNFILTERED.
tokensany
Список идентификаторов токенов (address:networkId) или адресов. Можно оставить пустым для обнаружения новых токенов.

get_detailed_pairs_stats

Получить статистику по корзинам для указанного токена в списке пар

Параметры

bucketCountnumber
Количество агрегированных значений для получения. Примечание: Каждый интервал времени имеет предопределенные размеры сегментов. Первые n-1 сегментов являются историческими. Последний сегмент является снимком текущих данных.
durationenumобязательный
Продолжительность для статистики.
networkIdnumberобязательный
Идентификатор сети, в которой находятся пары.
pairAddressesstring[]обязательный
Массив адресов контрактов пар

get_detailed_pair_stats

Получить статистику по корзинам для заданного токена в паре

Параметры

addressstringобязательный
Адрес контракта пары
bucketCountnumber
Количество агрегированных значений для получения. Примечание: Каждый интервал времени имеет предопределенные размеры сегментов. Первые n-1 сегментов являются историческими. Последний сегмент является снимком текущих данных.
durationenumобязательный
Продолжительность для статистики.
networkIdnumberобязательный
Идентификатор сети, в которой находится пара.
statsTypeenum
Тип возвращаемой статистики. Может быть FILTERED или UNFILTERED.
timestampnumber
tokenOfInterestenum

get_latest_tokens

Получает список последних развернутых контрактов токенов (только для планов Codex Growth и Enterprise). Примечание: эта конечная точка доступна только в сетях Ethereum, Optimum, Base и Arbitrum (идентификаторы сетей: 1, 10, 8453 и 42161).

Параметры

limitnumber
Максимальное количество возвращаемых элементов
networkFilternumber[]обязательный
offsetnumber

get_liquidity_locks

Получить блокировки ликвидности для пары, включая детали о заблокированных суммах, продолжительности блокировки и информацию о владельце (только для Codex Growth и Enterprise Plans)

Параметры

addressstringобязательный
Адрес контракта пары
cursorstring
Курсор для пагинации
networkIdnumberобязательный
Идентификатор сети, в которой находится пара.

get_liquidity_metadata

Получает метаданные ликвидности для пары, включая данные о разблокированной и заблокированной ликвидности.

Параметры

addressstringобязательный
Адрес контракта пары
networkIdnumberобязательный
Идентификатор сети, в которой находится пара.

get_networks

Получает список всех блокчейн-сетей, поддерживаемых Codex.

Параметры

Без параметров.

get_network_stats

Получает метаданные и статистику для заданной сети.

Параметры

networkIdnumberобязательный
Идентификатор сети, для которого нужно получить статистику.

get_network_status

Получить статус конкретной блокчейн-сети

Параметры

networkIdnumberобязательный
Идентификатор сети, для которого нужно получить статус.

get_pair_metadata

Получить метаданные для пары токенов, включая цену, объём и статистику ликвидности за разные временные промежутки.

Параметры

addressstringобязательный
Адрес контракта пары
networkIdnumberобязательный
Идентификатор сети, в которой находится пара.
quoteTokenenum
Интересующий токен (token0 или token1)
statsTypeenum
Тип возвращаемой статистики. Может быть FILTERED или UNFILTERED.

get_token_balances

Получить балансы токенов для кошелька (только для планов Codex Growth и Enterprise)

Параметры

cursorstring
Курсор для пагинации
filterTokenstring
Необязательный токен, который фильтрует балансы.
includeNativeboolean
Включает балансы нативных токенов.
networkIdnumberобязательный
Идентификатор сети, в которой находится кошелёк
walletAddressstringобязательный
Адрес кошелька, для которого нужно получить балансы

get_token_chart_data

Возвращает данные для столбчатой диаграммы для отслеживания изменения цены токена с течением времени. Можно запросить, используя адрес пары или адрес токена.

Параметры

addressstringобязательный
Адрес пары или адрес токена, для которого нужно получить данные графика. Если указан адрес токена, будет использоваться основная пара этого токена.
countbacknumber
currencyCodestring
fromnumberобязательный
Unix-метка
networkIdnumberобязательный
Идентификатор сети, в которой находится пара или токен
quoteTokenenum
Интересующий токен (token0 или token1)
removeEmptyBarsboolean
removeLeadingNullValuesany
resolutionstringобязательный
Таймфрейм для каждой свечи. Доступные варианты: 1, 5, 15, 30, 60, 240, 720, 1Д, 7Д.
statsTypeenum
Тип возвращаемой статистики. Может быть FILTERED или UNFILTERED.
symbolTypeenum
toanyобязательный

get_token_chart_urls

Изображения графиков для пар токенов (только для тарифов Codex Growth и Enterprise)

Параметры

networkIdnumberобязательный
Идентификатор сети, в которой находится пара.
pairAddressstringобязательный
Адрес контракта пары
quoteTokenenum
Интересующий токен (token0 или token1)

get_token_events

Получить транзакции для пары токенов

Параметры

cursorstring
Курсор для использования в пагинации.
directionenum
Направление сортировки событий
limitnumber
Максимальное количество возвращаемых событий.
queryobjectобязательный
Параметры запроса для фильтрации событий токенов.

get_token_events_for_maker

Получить список событий токенов для указанного адреса кошелька

Параметры

cursorstring
Курсор для использования в пагинации.
directionenum
Направление сортировки событий
limitnumber
Максимальное количество возвращаемых событий.
queryobjectобязательный
Параметры запроса для фильтрации событий токенов.

get_token_holders

Возвращает список кошельков, у которых есть заданный токен, отсортированный по убыванию количества. Также показывает уникальное количество держателей этого токена. (Только для планов Codex Growth и Enterprise)

Параметры

addressstringобязательный
Адрес контракта токена.
cursorstring
Курсор для пагинации
networkIdnumberобязательный
Идентификатор сети, в которой находится токен.
sortobject
Варианты сортировки списка держателей

get_token_info

Получает подробную информацию о конкретном токене.

Параметры

addressstringобязательный
Адрес контракта токена.
networkIdnumberобязательный
Идентификатор сети, в которой находится токен.

get_token_pairs

Получить список пар для токена

Параметры

addressstringобязательный
Адрес контракта токена.
limitnumber
Максимальное количество возвращаемых пар (по умолчанию: 10)
networkIdnumberобязательный
Идентификатор сети, в которой находится токен.

get_token_pairs_with_metadata

Получить пары с метаданными для конкретного токена

Параметры

addressstringобязательный
Адрес контракта токена.
limitnumber
Максимальное количество возвращаемых пар (по умолчанию: 10)
networkIdnumberобязательный
Идентификатор сети, в которой находится токен.

get_token_prices

Получает текущие или исторические цены для списка токенов

Параметры

inputsobject[]обязательный

get_tokens

Получить подробную информацию о нескольких токенах

Параметры

idsobject[]обязательный

get_token_sparklines

Получить список простых графиков токенов (спарклайнов) для заданных токенов

Параметры

addressesstring[]обязательный
Массив адресов контрактов токенов
networkIdnumberобязательный
Идентификатор сети, в которой находятся токены

get_top_10_holders_percent

Получить процент токенов, удерживаемых 10 крупнейшими держателями

Параметры

addressstringобязательный
Адрес контракта токена.
networkIdnumberобязательный
Идентификатор сети, в которой находится токен.

`0.1.3`основная	05.04.2025
`0.1.2`	05.04.2025
`0.1.1`	05.04.2025
`0.1.0`	05.04.2025

Выберите клиент, чтобы установить codex-data/codex-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "codex-data-codex-mcp-oz0nok8wdf": {
      "command": "npx",
      "args": [
        "-y",
        "@codex-data/codex-mcp"
      ],
      "env": {
        "CODEX_API_KEY": "<your-codex-api-key>"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "codex-data-codex-mcp-oz0nok8wdf": {
      "command": "npx",
      "args": [
        "-y",
        "@codex-data/codex-mcp"
      ],
      "env": {
        "CODEX_API_KEY": "<your-codex-api-key>"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "codex-data-codex-mcp-oz0nok8wdf": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@codex-data/codex-mcp"
      ],
      "env": {
        "CODEX_API_KEY": "<your-codex-api-key>"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"codex-data-codex-mcp-oz0nok8wdf\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@codex-data/codex-mcp\"],\"env\":{\"CODEX_API_KEY\":\"<your-codex-api-key>\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "codex-data-codex-mcp-oz0nok8wdf": {
      "command": "npx",
      "args": [
        "-y",
        "@codex-data/codex-mcp"
      ],
      "env": {
        "CODEX_API_KEY": "<your-codex-api-key>"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add codex-data-codex-mcp-oz0nok8wdf --env CODEX_API_KEY=<your-codex-api-key> -- npx -y @codex-data/codex-mcp

Либо через JSON-конфиг:

claude mcp add-json codex-data-codex-mcp-oz0nok8wdf "{\"command\":\"npx\",\"args\":[\"-y\",\"@codex-data/codex-mcp\"],\"env\":{\"CODEX_API_KEY\":\"<your-codex-api-key>\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add codex-data-codex-mcp-oz0nok8wdf --env CODEX_API_KEY=<your-codex-api-key> -- npx -y @codex-data/codex-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.codex-data-codex-mcp-oz0nok8wdf]
command = "npx"
args = ["-y", "@codex-data/codex-mcp"]

[mcp_servers.codex-data-codex-mcp-oz0nok8wdf.env]
CODEX_API_KEY = "<your-codex-api-key>"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите codex-data/codex-mcp, а в поле команды запуска — строку ниже:

npx -y @codex-data/codex-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "codex-data-codex-mcp-oz0nok8wdf": {
      "command": "npx",
      "args": [
        "-y",
        "@codex-data/codex-mcp"
      ],
      "env": {
        "CODEX_API_KEY": "<your-codex-api-key>"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "codex-data-codex-mcp-oz0nok8wdf": {
      "command": "npx",
      "args": [
        "-y",
        "@codex-data/codex-mcp"
      ],
      "env": {
        "CODEX_API_KEY": "<your-codex-api-key>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например codex-data-codex-mcp-oz0nok8wdf.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: codex-data-codex-mcp-oz0nok8wdf
    command: npx
    args:
      - "-y"
      - "@codex-data/codex-mcp"
    env:
      CODEX_API_KEY: <your-codex-api-key>

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "codex-data-codex-mcp-oz0nok8wdf": {
      "command": "npx",
      "args": [
        "-y",
        "@codex-data/codex-mcp"
      ],
      "env": {
        "CODEX_API_KEY": "<your-codex-api-key>"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@codex-data/codex-mcp"
  ],
  "env": {
    "CODEX_API_KEY": "<your-codex-api-key>"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #196
Звезд на Github: 25
Форков на Github: 7
Загрузок: 493
Язык реализации: TypeScript
Лицензия: неизвестно
Официальный сервер: Нет
Дата обновления данных: 19.10 в 07:03
Идентификатор: VL-nr4Goqpd-SvSL
Категории: Блокчейн

codex-data/codex-mcp

Codex MCP Server

Installation

Usage

Using npx (No Installation Required)

Running the Server Locally

Integration with Claude Desktop

Часто задаваемые вопросы

Похожие MCP-сервера

tatumio/blockchain-mcp

JamesANZ/bitcoin-mcp

mcpdotdirect/starknet-mcp-server

hypeprinter007-stack/anchor-x402-mcp

tumf/web3-mcp

IndigoProtocol/cardano-mcp