evmquery-mcp

Read any contract on any EVM chain through a single MCP endpoint.

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Execute Query: Execute a CEL expression against EVM smart contracts. Returns the query result, execution metadata, and credits consumed. Contract names from schema.contracts become variables in the ex
  • Describe Schema: Describe the available methods, properties, and context for the given schema. Returns all callable methods on each contract, plus available CEL helper functions, list macros, and type

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Read any contract on any EVM chain through a single MCP endpoint.

Ask questions in plain English and evmquery resolves the right contract, ABI, and call for you — then returns a clean, typed answer.

What it does

  • Resolves contracts automatically
  • Calls any view function without you wiring up an ABI
  • Returns structured results ready for the next tool in your chain

Good for

  • Wallet/allowance/balance checks
  • Token metadata (ERC-20, ERC-721, ERC-1155)
  • Quick reads against unknown or new contracts during research

Currently supported chains

  • Ethereum Mainnet
  • Base
  • BNB Smart Chain

Как подключить

Как подключить evmquery-mcp к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://evmquery-mcp.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить evmquery-mcp к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://evmquery-mcp.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить evmquery-mcp к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://evmquery-mcp.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (2)

Технические названия из tools/list. Нужны только разработчикам.

execute_queryExecute a CEL expression against EVM smart contracts. Returns the query result, execution metadata, and credits consumed. Contract names from schema.contracts become variables in the expression. Use describe_schema first to discover callable methods and available CEL functions (formatUnits, cel.bind, list macros, etc.). Example — read an ERC-20 balance: chain: 'evm_ethereum' schema: { contracts: { usdc: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' }, context: { wallet: 'sol_address' } } context: { wallet: '0x1234...' } expression: 'formatUnits(usdc.balanceOf(wallet), usdc.decimals())' Pricing: 1 credit for pure CEL, otherwise totalCalls + totalRounds credits (e.g. a single balanceOf costs 2 credits). Response format: result value with type annotation, block metadata (block number, on-chain calls, execution rounds) when applicable, and credits consumed.
describe_schemaDescribe the available methods, properties, and context for the given schema. Returns all callable methods on each contract, plus available CEL helper functions, list macros, and type definitions. Call this before writing expressions to discover what is queryable. Common patterns: ERC-20 balance: formatUnits(usdc.balanceOf(wallet), usdc.decimals()) Multi-wallet balances: wallets.map(w, formatUnits(token.balanceOf(w), token.decimals())) Filter non-zero holders: wallets.filter(w, token.balanceOf(w) > solInt(0)) Check all holders meet threshold: wallets.all(w, token.balanceOf(w) > parseUnits('100', 18)) Any wallet has balance: wallets.exists(w, token.balanceOf(w) > solInt(0)) Bind intermediate values: cel.bind(supply, token.totalSupply(), formatUnits(supply, token.decimals())) Native ETH balance: solAddress('0x...').balance() Is zero address: isZeroAddress(owner)