MCP-сервер BlockVectra: інструменти блокчейн-RPC та документації для AI-агентів

MCP-сервер BlockVectra за адресою https://docs.blockvectra.com/mcp надає розробникам та AI-агентам 15 інструментів для викликів блокчейн-RPC, статусу мереж, цін та документації. Для підключення API key не потрібен: 10 інструментів не потребують його ніколи; решта використовують x-api-key із заголовків вашого клієнта. Встановлення в один рядок: claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

Ендпоінт — MCP ендпоінт (HTTP POST, що приймає JSON-RPC 2.0; GET повертає 405), працює через MCP Streamable HTTP і без стану. Про HTTP-файли, публічний JSON та процес реєстрації навколо нього див. Підключення AI-агентів.

Інструменти

Ця таблиця генерується з реєстру інструментів сервера, тому в ній перелічено кожен інструмент, який повертає tools/list. Кожен інструмент приймає аргументи й повертає поля, описані в його власній схемі tools/list.

Безпека API key

Інструментам з ключем потрібен API key, щоб виконувати запити Data API, операції з акаунтом або методи RPC поза публічними методами мережі.

• Зчитування виключно із заголовків: API key зчитується лише з HTTP-заголовків запиту клієнта MCP (x-api-key: rgw_... або Authorization: Bearer rgw_...).
• Ніколи не додавайте ключі в чат: ніколи не передавайте API key або приватні ключі в аргументах інструментів і не вставляйте їх у чат. Аргументи інструментів та історія чату потрапляють до журналів і контекстів розмови; передача ключів в аргументах буде відхилена.

Якщо інструменти з ключем викликаються без заголовка API key, вони повертають isError: true і спрямовують агента до how_to_get_api_key та посібника з програмної реєстрації.

Встановлення у вашому клієнті

Ви можете підключитися до MCP-сервера документації BlockVectra за адресою https://docs.blockvectra.com/mcp у типових середовищах розробки та фреймворках.

Почніть без API key. Підключіться до ендпоінта MCP, викличте list_chains, а потім прочитайте quickstart за допомогою read_doc. Додайте API key у HTTP-заголовки вашого клієнта, коли вам знадобляться Data API або інструменти акаунта. Доступ до RPC без ключа визначається політикою публічних методів кожної мережі.

Заголовок x-api-key є необов'язковим. Без API key клієнти можуть використовувати всі інструменти документації лише для читання (read_doc, search_docs, list_docs), дослідження мереж (list_chains), актуальний статус (get_status), оцінку вартості (get_pricing, estimate_usage), пояснення помилок (explain_error) та методи, дозволені на публічних ендпоінтах. Якщо ви використовуєте інструменти з ключем (rpc_call для обмежених методів, send_raw_transaction, data_api_get, get_account та get_deposit_address), налаштуйте заголовок x-api-key зі своїм API key.

Claude Code

Підключіться до MCP-сервера через CLI:

claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

Щоб додати необов'язковий API key для автентифікованих інструментів, передайте параметр --header (або -H) і послайтеся на змінну середовища замість вставлення ключа. Використовуйте одинарні лапки, щоб оболонка її не розгортала; Claude Code розгортає ${BLOCKVECTRA_API_KEY} під час запуску сесії:

claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp \
  --header 'x-api-key: ${BLOCKVECTRA_API_KEY}'

Та сама конфігурація у вигляді .mcp.json рівня проєкту (саме його записує claude mcp add --scope project):

{
  "mcpServers": {
    "blockvectra-docs": {
      "type": "http",
      "url": "https://docs.blockvectra.com/mcp",
      "headers": { "x-api-key": "${BLOCKVECTRA_API_KEY}" }
    }
  }
}

Експортуйте BLOCKVECTRA_API_KEY у середовищі, яке запускає claude. Claude Code просить підтвердити сервер із .mcp.json рівня проєкту під час першого запуску claude у цьому каталозі; до того claude mcp list показує його як Pending approval.

Для скриптів і CI передайте файл через --mcp-config та дозвольте інструменти сервера. Ключ залишається в середовищі, а клієнт MCP додає заголовок сам, тому агенту не потрібна команда оболонки, що розгортає $BLOCKVECTRA_API_KEY (перевірка дозволів Claude Code відхиляла такі команди в неінтерактивному режимі з повідомленням Contains simple_expansion):

claude -p "Use rpc_call to run eth_blockNumber on base_mainnet" \
  --mcp-config ./mcp.json --allowedTools "mcp__blockvectra-docs__*"

Якщо ключ задано, результат rpc_call також містить cu_charged і balance_units; виклик без ключа повертає лише відповідь JSON-RPC. Якщо змінну не задано, клієнт надсилає буквальний текст заголовка, і сервер відповідає invalid_api_key (код помилки -32024) замість переходу на ендпоінт без ключа.

Офіційна документація: Документація Claude Code MCP.

Cursor

Додайте сервер до конфігурації MCP у Cursor:

{
  "mcpServers": {
    "blockvectra": {
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}

Cursor також підтримує встановлення в один клік через діплінки за допомогою закодованої в base64 конфігурації eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9 (що відповідає {"url":"https://docs.blockvectra.com/mcp"}):

cursor://anysphere.cursor-deeplink/mcp/install?name=blockvectra&config=eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9

Коли вам знадобляться автентифіковані інструменти (Data API або керування акаунтом), додайте об'єкт headers зі своїм API key:

{
  "mcpServers": {
    "blockvectra": {
      "url": "https://docs.blockvectra.com/mcp",
      "headers": {
        "x-api-key": "${env:BLOCKVECTRA_API_KEY}"
      }
    }
  }
}

Форма ${env:NAME} відповідає документації Cursor, яка розгортає змінні в url і headers; цю форму тут із Cursor не запускали. Помістіть файл у .cursor/mcp.json (проєкт) або ~/.cursor/mcp.json (глобально).

Офіційна документація: Документація Cursor MCP та Посилання для встановлення Cursor.

VS Code

У VS Code налаштуйте сервер у файлі .vscode/mcp.json під кореневим ключем servers з типом type: "http":

{
  "servers": {
    "blockvectra": {
      "type": "http",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}

Коли вам знадобляться автентифіковані інструменти, додайте об'єкт headers:

{
  "servers": {
    "blockvectra": {
      "type": "http",
      "url": "https://docs.blockvectra.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Для збереження конфіденційних облікових даних VS Code підтримує посилання на вхідні змінні або файли середовища замість прямого внесення ключів у конфігурацію. Ви також можете додавати сервери за допомогою дії Command Palette MCP: Add Server.

Офіційна документація: Документація серверів VS Code MCP та Довідник з конфігурації VS Code MCP.

Codex

Додайте сервер за допомогою CLI OpenAI Codex:

codex mcp add blockvectra --url https://docs.blockvectra.com/mcp

У config.toml налаштуйте URL сервера:

[mcp_servers.blockvectra]
url = "https://docs.blockvectra.com/mcp"

Коли вам знадобляться автентифіковані інструменти, налаштуйте заголовки запитів у config.toml:

[mcp_servers.blockvectra]
url = "https://docs.blockvectra.com/mcp"
http_headers = { "x-api-key" = "YOUR_API_KEY" }

Або зіставте заголовок зі змінної середовища:

[mcp_servers.blockvectra]
url = "https://docs.blockvectra.com/mcp"
env_http_headers = { "x-api-key" = "BLOCKVECTRA_API_KEY" }

Офіційна документація: Документація OpenAI Codex CLI MCP.

Gemini CLI

У конфігурації Gemini CLI додайте сервер у mcpServers, використовуючи httpUrl для Streamable HTTP:

{
  "mcpServers": {
    "blockvectra": {
      "httpUrl": "https://docs.blockvectra.com/mcp"
    }
  }
}

Коли вам знадобляться автентифіковані інструменти, додайте об'єкт headers зі своїм API key:

{
  "mcpServers": {
    "blockvectra": {
      "httpUrl": "https://docs.blockvectra.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Офіційна документація: Документація MCP-сервера Gemini CLI.

OpenAI Responses API

Під час виклику OpenAI Responses API передайте MCP-сервер у масиві tools із типом type: "mcp":

OPENAI_API_BASE="https://api.openai.com/v1"
curl "$OPENAI_API_BASE/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "tools": [{
      "type": "mcp",
      "server_label": "blockvectra",
      "server_url": "https://docs.blockvectra.com/mcp",
      "require_approval": "never"
    }],
    "input": "..."
  }'

Коли вам знадобляться автентифіковані інструменти, включіть поле headers у визначення інструмента:

{
  "type": "mcp",
  "server_label": "blockvectra",
  "server_url": "https://docs.blockvectra.com/mcp",
  "headers": { "x-api-key": "YOUR_API_KEY" },
  "require_approval": "never"
}

Офіційна документація: Посібник з інструментів OpenAI MCP та Довідник OpenAI Responses API.

Windsurf

У Windsurf налаштуйте сервер у розділі mcpServers, використовуючи поле serverUrl:

{
  "mcpServers": {
    "blockvectra": {
      "serverUrl": "https://docs.blockvectra.com/mcp"
    }
  }
}

Коли вам знадобляться автентифіковані інструменти, додайте об'єкт headers зі своїм API key:

{
  "mcpServers": {
    "blockvectra": {
      "serverUrl": "https://docs.blockvectra.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf також підтримує посилання на змінні середовища, наприклад "x-api-key": "${env:BLOCKVECTRA_API_KEY}".

Офіційна документація: Документація Windsurf MCP.

Claude Desktop та claude.ai

Користувацькі конектори налаштовуються через інтерфейс користувача:

• claude.ai: перейдіть до Customize > Connectors, натисніть + Add, виберіть Add custom connector та введіть URL:

  Скопіювати текст

  https://docs.blockvectra.com/mcp

• Claude Desktop: відкрийте меню налаштувань акаунта та налаштуйте користувацькі конектори через інтерфейс конекторів.

Підключення до цього URL дозволяє Claude шукати посібники, читати документацію у форматі Markdown, переглядати підтримувані мережі, перевіряти статус мережі та розраховувати оцінку вартості без облікових даних.

Офіційна документація: Посібник з користувацьких конекторів Claude.

Перевірка підключення та усунення несправностей

У Claude Code claude mcp list показує статус кожного сервера. Щоб дізнатися кількість фактично зареєстрованих інструментів, запустіть команду один раз із потоковим виводом і прочитайте подію init або прочитайте журнал налагодження:

claude -p "say ok" --mcp-config ./mcp.json --output-format stream-json --verbose
claude -p "say ok" --mcp-config ./mcp.json --debug mcp --debug-file mcp-debug.log

Робоче підключення показує "status": "connected" та інструменти mcp__blockvectra-docs__* (такі як list_chains і rpc_call) у події init. У журналі налагодження шукайте рядки про blockvectra-docs, як-от Successfully connected і Failed to fetch tools. Якщо сервер має статус connected, але інструментів немає, прочитайте причину, яку журнал налагодження (--debug mcp) повідомляє після Failed to fetch tools. Щоб переконатися, що сам сервер справний, скористайтеся викликами curl нижче.

Виклик ендпоінта MCP без клієнта

Ендпоінт працює як JSON-RPC 2.0 поверх HTTP POST, тому його може викликати будь-який HTTP-клієнт:

curl -s https://docs.blockvectra.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s https://docs.blockvectra.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"rpc_call","arguments":{"chain":"base_mainnet","method":"eth_blockNumber","params":[]}}}'

Перший виклик повертає список інструментів; другий повертає відповідь JSON-RPC у result.structuredContent. Ідентифікатори мереж — це slug-и, як-от base_mainnet; отримайте їх із list_chains. Інструментам з ключем потрібен заголовок x-api-key; цей виклик читає ваш акаунт із ключем зі змінної середовища:

curl -s https://docs.blockvectra.com/mcp -H 'content-type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_account","arguments":{}}}'

Він повертає key_id, plan, balance_units, balance_cu та ліміти швидкості ключа в result.structuredContent. Якщо ваш агент виконує команди через оболонку з контролем дозволів, таке розгортання змінної може бути заблоковане; натомість налаштуйте заголовок у клієнті MCP.

Поширені запитання

Чи потрібен MCP-серверу BlockVectra API key?

Ні. Для підключення ключ не потрібен, а 10 із 15 інструментів не потребують його ніколи. rpc_call і send_raw_transaction працюють без ключа лише для методів із public.methods мережі (прочитайте їх через list_chains). data_api_get, get_account і get_deposit_address потребують заголовка x-api-key.

Чи може MCP-сервер створювати або відкликати API key?

Ні. Жоден інструмент не створює, не перелічує й не відкликає API key. how_to_get_api_key лише повертає кроки; агент створює ключ через HTTP за програмною реєстрацією, а люди створюють його в консолі. Ключі ніколи не проходять через аргументи інструментів.

Чи може агент надсилати транзакції через MCP-сервер?

Він може транслювати, але не підписувати. rpc_call відхиляє методи запису, такі як eth_sendRawTransaction, eth_sendTransaction, eth_sign і personal_*. send_raw_transaction транслює транзакцію, яку ви вже підписали локально, через eth_sendRawTransaction; сервер ніколи не зберігає й не бачить приватного ключа.

Що відбувається, коли виклик завершується помилкою?

Помилки інструментів повертають isError: true зі структурованою причиною. Скористайтеся explain_error або довідником кодів помилок, щоб побачити, чи тарифікується збій і чи варто повторювати спробу.

Пов'язане

• Підключення AI-агентів: машинозчитувані файли, публічні JSON-ендпоінти та робочий процес вибору мережі.
• Програмна реєстрація: створення API key за підписом гаманця, без браузера.
• Рецепти для фреймворків агентів: ElizaOS, viem, wagmi та Coinbase AgentKit.
• Коди помилок: кожна помилка з правилами тарифікації та повторних спроб.