Server MCP BlockVectra: alat blockchain RPC dan dokumentasi untuk AI Agent

Server MCP BlockVectra di https://docs.blockvectra.com/mcp memberi pengembang dan AI Agent 15 alat untuk panggilan blockchain RPC, status chain, harga, dan dokumentasi. Untuk terhubung tidak diperlukan API key: 10 alat tidak pernah memerlukannya; alat lainnya menggunakan x-api-key dari header klien Anda. Instal dalam satu baris: claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

Endpoint-nya adalah Endpoint MCP (HTTP POST menerima JSON-RPC 2.0; GET mengembalikan 405), dilayani melalui MCP Streamable HTTP dan tanpa state. Untuk file HTTP, JSON publik, dan alur pendaftaran yang menyertainya, lihat Hubungkan AI Agent.

Alat

Tabel ini dihasilkan dari registri alat server, sehingga memuat setiap alat yang dikembalikan tools/list. Setiap alat menerima argumen dan mengembalikan bidang sebagaimana dijelaskan dalam skema tools/list-nya sendiri.

Keamanan API key

Alat yang memerlukan API key membutuhkannya untuk menjalankan permintaan Data API, operasi akun, atau metode RPC di luar metode publik suatu chain.

• Baca hanya dari header: API key dibaca hanya dari header permintaan HTTP klien MCP (x-api-key: rgw_... atau Authorization: Bearer rgw_...).
• Jangan pernah memasukkan API key ke obrolan: Jangan pernah mengirim API key atau private key dalam argumen alat atau menempelkannya ke obrolan. Argumen alat dan riwayat obrolan masuk ke log serta konteks percakapan; pengiriman API key dalam argumen akan ditolak.

Jika dipanggil tanpa header API key, alat yang memerlukan API key mengembalikan isError: true dan mengarahkan Agent ke how_to_get_api_key serta panduan pendaftaran terprogram.

Pasang di klien Anda

Anda dapat terhubung ke server MCP dokumentasi BlockVectra di https://docs.blockvectra.com/mcp melalui berbagai lingkungan pengembangan dan framework umum.

Mulai tanpa API key. Hubungkan ke endpoint MCP, panggil list_chains, lalu baca quickstart dengan read_doc. Tambahkan API key dalam header HTTP klien ketika memerlukan alat Data API atau akun. Akses RPC tanpa API key mengikuti kebijakan metode publik setiap chain.

Header x-api-key bersifat opsional. Tanpa API key, klien dapat menggunakan semua alat dokumentasi hanya-baca (read_doc, search_docs, list_docs), penemuan chain (list_chains), status langsung (get_status), estimasi harga (get_pricing, estimate_usage), penjelasan error (explain_error), serta metode yang diizinkan pada endpoint publik. Saat menggunakan alat yang memerlukan API key (rpc_call pada metode terbatas, send_raw_transaction, data_api_get, get_account, dan get_deposit_address), konfigurasikan header x-api-key dengan API key Anda.

Claude Code

Hubungkan ke server MCP menggunakan CLI:

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

Untuk menyertakan API key opsional bagi alat terautentikasi, gunakan opsi --header (atau -H) dan rujuk variabel lingkungan alih-alih menempelkan API key. Gunakan tanda kutip tunggal agar shell Anda tidak memperluasnya; Claude Code memperluas ${BLOCKVECTRA_API_KEY} saat memulai sesi:

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

Konfigurasi yang sama sebagai .mcp.json tingkat proyek (juga yang ditulis oleh claude mcp add --scope project):

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

Ekspor BLOCKVECTRA_API_KEY di lingkungan yang menjalankan claude. Claude Code meminta Anda menyetujui server .mcp.json tingkat proyek saat pertama kali Anda menjalankan claude di direktori tersebut; sampai saat itu, claude mcp list menampilkannya sebagai Pending approval.

Untuk skrip dan CI, berikan file tersebut dengan --mcp-config dan izinkan alat server. API key tetap berada di lingkungan dan klien MCP menambahkan header sendiri, sehingga Agent tidak memerlukan perintah shell yang memperluas $BLOCKVECTRA_API_KEY (pemeriksaan izin Claude Code menolak perintah semacam itu dalam mode non-interaktif dengan Contains simple_expansion):

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

Dengan API key yang sudah diatur, hasil rpc_call juga memuat cu_charged dan balance_units; panggilan tanpa API key hanya mengembalikan respons JSON-RPC. Jika variabel tidak diatur, klien mengirim teks header apa adanya dan server menjawab invalid_api_key (kode error -32024) alih-alih beralih ke endpoint tanpa API key.

Dokumentasi resmi: Dokumentasi MCP Claude Code.

Cursor

Tambahkan server ke konfigurasi MCP Cursor:

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

Cursor juga mendukung instalasi sekali klik melalui deep link menggunakan konfigurasi berpengodean base64 eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9 (mewakili {"url":"https://docs.blockvectra.com/mcp"}):

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

Ketika memerlukan alat terautentikasi (Data API atau pengelolaan akun), tambahkan objek headers dengan API key Anda:

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

Bentuk ${env:NAME} mengikuti dokumentasi Cursor, yang menyelesaikan variabel dalam url dan headers; bentuk ini belum dijalankan terhadap Cursor di sini. Letakkan file di .cursor/mcp.json (proyek) atau ~/.cursor/mcp.json (global).

Dokumentasi resmi: Dokumentasi MCP Cursor dan tautan instalasi Cursor.

VS Code

Di VS Code, konfigurasikan server dalam .vscode/mcp.json di bawah kunci tingkat atas servers dengan type: "http":

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

Ketika memerlukan alat terautentikasi, tambahkan objek headers:

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

Saat menyimpan kredensial sensitif, VS Code mendukung referensi variabel input atau file lingkungan alih-alih menulis API key secara tetap. Anda juga dapat menambahkan server menggunakan tindakan Command Palette MCP: Add Server.

Dokumentasi resmi: Dokumentasi server MCP VS Code dan referensi konfigurasi MCP VS Code.

Codex

Tambahkan server menggunakan OpenAI Codex CLI:

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

Dalam config.toml, konfigurasikan URL server:

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

Ketika memerlukan alat terautentikasi, konfigurasikan header permintaan dalam config.toml:

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

Atau, petakan header dari variabel lingkungan:

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

Dokumentasi resmi: Dokumentasi MCP OpenAI Codex CLI.

Gemini CLI

Dalam konfigurasi Gemini CLI, tambahkan server di bawah mcpServers menggunakan httpUrl untuk Streamable HTTP:

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

Ketika memerlukan alat terautentikasi, tambahkan objek headers dengan API key Anda:

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

Dokumentasi resmi: Dokumentasi server MCP Gemini CLI.

OpenAI Responses API

Saat memanggil OpenAI Responses API, sertakan server MCP dalam array tools dengan 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": "..."
  }'

Ketika memerlukan alat terautentikasi, sertakan bidang headers dalam definisi alat:

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

Dokumentasi resmi: Panduan alat MCP OpenAI dan referensi OpenAI Responses API.

Windsurf

Di Windsurf, konfigurasikan server di bawah mcpServers menggunakan bidang serverUrl:

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

Ketika memerlukan alat terautentikasi, tambahkan objek headers dengan API key Anda:

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

Windsurf juga mendukung referensi variabel lingkungan, seperti "x-api-key": "${env:BLOCKVECTRA_API_KEY}".

Dokumentasi resmi: Dokumentasi MCP Windsurf.

Claude Desktop dan claude.ai

Konektor kustom dikonfigurasikan melalui antarmuka pengguna:

• claude.ai: Buka Customize > Connectors, klik + Add, pilih Add custom connector, lalu masukkan URL:

  Salin teks

  https://docs.blockvectra.com/mcp

• Claude Desktop: Buka menu pengaturan akun dan konfigurasikan konektor kustom melalui antarmuka konektor.

Menghubungkan ke URL memungkinkan Claude mencari panduan, membaca dokumentasi Markdown, memeriksa chain yang didukung, memeriksa status jaringan, dan menghitung estimasi harga tanpa kredensial.

Dokumentasi resmi: Panduan konektor kustom Claude.

Periksa koneksi dan atasi masalah

Di Claude Code, claude mcp list menampilkan status setiap server. Untuk jumlah alat yang benar-benar terdaftar, jalankan sekali dengan keluaran stream dan baca peristiwa init, atau baca log debug:

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

Koneksi yang berfungsi menampilkan "status": "connected" dan alat mcp__blockvectra-docs__* (seperti list_chains dan rpc_call) dalam peristiwa init. Di log debug, cari baris tentang blockvectra-docs seperti Successfully connected dan Failed to fetch tools. Jika server berstatus connected tetapi tidak ada alat yang muncul, baca alasan yang dilaporkan log debug (--debug mcp) setelah Failed to fetch tools. Untuk memeriksa bahwa server itu sendiri sehat, gunakan panggilan curl di bawah.

Panggil endpoint MCP tanpa klien

Endpoint-nya adalah JSON-RPC 2.0 melalui HTTP POST, sehingga klien HTTP apa pun dapat memanggilnya:

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":[]}}}'

Panggilan pertama mengembalikan daftar alat; panggilan kedua mengembalikan respons JSON-RPC dalam result.structuredContent. Pengenal chain berupa slug seperti base_mainnet; dapatkan dari list_chains. Alat yang memerlukan API key membutuhkan header x-api-key; panggilan ini membaca akun Anda dengan API key dari variabel lingkungan:

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":{}}}'

Panggilan ini mengembalikan key_id, plan, balance_units, balance_cu, dan batas laju API key dalam result.structuredContent. Jika Agent Anda menjalankan perintah melalui shell yang dibatasi izin, perluasan variabel tersebut mungkin diblokir; konfigurasikan header di klien MCP sebagai gantinya.

FAQ

Apakah server MCP BlockVectra memerlukan API key?

Tidak. Untuk terhubung tidak diperlukan API key, dan 10 dari 15 alat tidak pernah memerlukannya. rpc_call dan send_raw_transaction berjalan tanpa API key hanya untuk metode dalam public.methods chain (baca dengan list_chains). data_api_get, get_account, dan get_deposit_address memerlukan header x-api-key.

Dapatkah server MCP membuat atau mencabut API key?

Tidak. Tidak ada alat yang membuat, mencantumkan, atau mencabut API key. how_to_get_api_key hanya mengembalikan langkah-langkahnya; Agent membuat API key melalui HTTP dengan mengikuti pendaftaran terprogram, dan manusia membuatnya di konsol. API key tidak pernah melewati argumen alat.

Dapatkah Agent mengirim transaksi melalui server MCP?

Agent dapat menyiarkan, bukan menandatangani. rpc_call menolak metode tulis seperti eth_sendRawTransaction, eth_sendTransaction, eth_sign, dan personal_*. send_raw_transaction menyiarkan transaksi yang sudah Anda tandatangani secara lokal dengan eth_sendRawTransaction; server tidak pernah memegang atau melihat private key.

Apa yang terjadi saat panggilan gagal?

Error alat mengembalikan isError: true dengan alasan terstruktur. Gunakan explain_error atau referensi kode error untuk melihat apakah kegagalan ditagih dan apakah perlu dicoba ulang.

Terkait

• Hubungkan AI Agent: file yang dapat dibaca mesin, endpoint JSON publik, dan alur pemilihan chain.
• Pendaftaran terprogram: buat API key dengan tanda tangan dompet, tanpa browser.
• Resep framework Agent: ElizaOS, viem, wagmi, dan Coinbase AgentKit.
• Kode error: setiap error beserta aturan penagihan dan percobaan ulang.