본문으로 건너뛰기

개발자와 AI 에이전트를 위한 블록체인 RPC 및 문서 MCP

개발자와 AI 에이전트는 키 없이 문서를 탐색하고, HTTP를 통해 자격 증명을 생성한 후 인증을 거쳐 지원되는 RPC 또는 Data API 엔드포인트를 호출할 수 있습니다.

키가 필요 없는 공개 엔드포인트: API 키 없이 https://api.blockvectra.com/v1/<chain>/public 에서 지원되는 체인을 호출할 수 있습니다. <chain>은 eth_mainnet과 같은 체인 이름으로 바꾸십시오. IP별 제한과 지원 체인 목록은 GET /v1/chains에서 확인할 수 있습니다.

빠른 답변

  • 키가 필요 없습니다. POST https://api.blockvectra.com/v1/<chain>/public는 계정이나 API 키 없이 29개 체인에서 동작하며, IP당 초당 3건의 요청을 처리합니다(버스트 20, 배치는 최대 10건).

    출처: GET /v1/chains
  • 지갑 가입은 네 번의 HTTP 호출이면 됩니다. 챌린지를 요청하고, Ethereum 지갑으로 서명(EIP-191)하고, 로그인(첫 로그인 시 계정이 생성됩니다)한 다음, POST /keys로 API 키를 생성합니다.

    출처: 프로그래밍 방식 가입 가이드
  • 명령어 하나로 문서 MCP 서버를 추가할 수 있으며 키는 필요 없습니다: claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

    출처: AI 에이전트 가이드
  • 가입하면 카드 없이 30,000,000 CU를 무료로 받습니다. 무료 플랜은 30일 주기로 운영되며, 모든 키가 공유하는 초당 25회 호출을 제공합니다. eth_call은 15 CU(1,000,000건당 $1.50)입니다.

    출처: GET /v1/plans
  • 사람과 같은 규칙: 키 생성과 해지, 잔액 조회, 온체인 충전은 모두 콘솔 전용이 아닌 HTTP 호출입니다. MCP 서버는 키를 생성하거나 해지하지 않습니다.

    출처: 프로그래밍 방식 가입 가이드

어떤 것을 써야 하나요?

원하는 것사용할 것첫 단계
계정 없이 지금 바로 체인 데이터 읽기키가 필요 없는 공개 엔드포인트eth_chainId JSON-RPC 본문으로 https://api.blockvectra.com/v1/<chain>/public에 POST합니다. 허용되는 메서드는 GET /v1/chains에 있습니다.
AI 어시스턴트가 문서, 체인, 상태, 요금을 읽고 읽기 전용 RPC를 호출하도록 하기문서 MCP 서버아래 MCP 섹션의 한 줄 명령어를 실행합니다. AI 에이전트 가이드를 참고하세요.
공개 목록 밖의 메서드, Data API 또는 키 자체의 제한 사용하기HTTP 가입 및 API 키POST /auth/siwe/challenge, 서명, 로그인 후 POST /keys. 단계는 프로그래밍 방식 가입 가이드에 있습니다.
폴링 대신 주소에 활동이 있을 때 알림 받기Webhook 주소 푸시Webhook 푸시 가이드에서 최대 1,000,000개 주소의 구독을 만듭니다.

키가 필요 없는 문서 MCP

문서 MCP 서버는 API 키가 필요 없으며 문서, 체인, 실시간 상태, 요금 및 사용량 추정에 관한 질문에 답변합니다.

문서 전용 MCP

search_docs · read_doc
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docs
문서 전용 MCP →(영어)
명령어 하나, API 키 불필요:
claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

다른 클라이언트:

Cline에서 MCP Servers → Configure → Configure MCP Servers를 열고 API 키가 필요 없는 다음 설정을 추가하세요:

{
  "mcpServers": {
    "blockvectra": {
      "type": "streamableHttp",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}
문서의 AI 에이전트 가이드 보기 →
키 없이 공개 RPC 호출 시도
지원되는 체인을 나열하고 공개 메서드에서 eth_chainId를 허용하는 체인을 선택하세요. 해당 체인과 메서드에 get_method_info를 사용한 다음 API 키 없이 rpc_call로 eth_chainId를 호출하세요. 반환된 체인 ID를 선택한 체인의 공개된 chain_id와 숫자로 비교하고 결과와 적용되는 공개 접근 한도를 보고하세요. ID가 없거나 유효하지 않거나 다르면 성공을 주장하지 말고 중단하여 보고하세요.

키가 필요한 메서드나 Data API를 사용하려면 HTTP로 가입하고 키를 생성한 다음 Data API 가이드를 따르세요. 잔액을 추가하려면 온체인으로 충전하세요.

연동 가이드

  • MCP 서버 도구 목록, 키 요구 사항, 클라이언트 설정.
  • LangChain LangChain 에이전트에 RPC 도구 또는 MCP 서버를 연결합니다.
  • ElizaOS EVM 플러그인이 BlockVectra 엔드포인트를 가리키게 합니다.
  • Coinbase AgentKit AgentKit에서 BlockVectra RPC URL을 사용합니다.
  • 주식 토큰 활동 Data API에서 주식 토큰의 일별 전송 활동을 읽습니다.

사람과 동일한 권한

HTTP를 통해 에이전트는 키를 생성(POST /keys)하고 해지(POST /keys/{key_id}/revoke)하며, 잔액을 조회(GET /v1/account)하고 온체인으로 충전할 수 있습니다. 한도와 요금은 콘솔을 쓰는 사람과 같습니다.

MCP 서버는 문서, 체인, 상태, 요금을 읽고, 읽기 전용 RPC를 호출하고(rpc_call), 서명된 트랜잭션을 브로드캐스트하며(send_raw_transaction), 클라이언트에 키를 설정하면 계정 잔액과 입금 주소도 읽을 수 있습니다. 키를 생성하거나 해지하는 도구는 없으므로 이는 HTTP로 처리하세요.

에이전트가 읽을 수 있는 요금 정보

GET /v1/plans는 각 메서드의 CU 가중치를 JSON으로 반환하므로 첫 호출 전에 비용을 예측할 수 있습니다.

GET /v1/plans 열기 →

USDC / USDT / USDG로 결제 →

무료 플랜

30,000,000 CU 가입 크레딧이 포함됩니다. 첫 과금 대상 사용 시점부터 30일 주기가 시작되며, 기간 종료 시 최대 30,000,000 CU까지 자동으로 다시 채워집니다(누적되지 않음). 모든 키는 평균 초당 25회 호출을 공유하며, 일시적 버스트가 허용됩니다. 각 키는 기본 100 CU/s 제한(버스트 400 CU)을 유지합니다.

약 2,000,000회의 eth_call

신용카드 불필요 — GitHub, Google 또는 지갑으로 즉시 가입할 수 있습니다.

기계 판독 가능한 진입점

계정 없이도 탐색 가능한 기계 판독 가능한 파일 및 카탈로그:

복사하여 사용할 수 있는 예제

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST https://api.blockvectra.com/v1/robinhood_mainnet \
  -H "content-type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

API 키가 아직 없으신가요?

Ethereum 지갑이 있는 경우: 브라우저 없이 프로그래밍 방식 가입 가이드에 따라 가입하고 키를 생성하세요. 지갑이 없는 경우: 사용자에게 https://console.blockvectra.com에서 로그인하여 키를 생성하고 환경 변수 BLOCKVECTRA_API_KEY로 설정하도록 요청하세요. 사용자에게 키를 채팅창에 붙여넣도록 요청하지 마세요.

자주 묻는 질문

가입 없이 블록체인 RPC를 호출할 수 있나요?

네. POST https://api.blockvectra.com/v1/<chain>/public는 계정이나 API 키 없이 29개 체인에서 동작하며, 체인별로 허용되는 메서드와 IP당 제한은 GET /v1/chains에 있습니다. 이 목록 밖의 메서드와 Data API에는 API 키가 필요합니다.

MCP 서버가 트랜잭션을 보낼 수 있나요?

브로드캐스트는 할 수 있지만 서명은 하지 못합니다. MCP 서버는 개인 키를 보관하지 않습니다. send_raw_transaction은 다른 곳에서 서명한 트랜잭션을, 공개 메서드에 eth_sendRawTransaction이 포함된 체인에서는 키가 필요 없는 엔드포인트를 통해, 또는 사용자의 API 키로 제출합니다. 키를 생성하거나 해지하는 도구는 없습니다. AI 에이전트 가이드에서 MCP 도구 보기 →

시작하기 전에 결제해야 하나요?

아니요. 첫 지갑 로그인 시 카드나 입금 없이 무료 크레딧 30,000,000 CU가 지급되며, 키가 필요 없는 엔드포인트는 계정조차 필요하지 않습니다. eth_call은 15 CU(1,000,000건당 $1.50)이고, 모든 요금은 GET /v1/plans에 있습니다. 더 필요하면 온체인으로 충전할 수 있습니다.

AI 에이전트는 브라우저 없이 API 키를 어떻게 받나요?

네 번의 HTTP 호출로 받습니다. POST /auth/siwe/challenge, 반환된 메시지를 Ethereum 지갑으로 서명(EIP-191), POST /auth/siwe/login(첫 로그인 시 계정이 생성됩니다), 그리고 POST /keys입니다. 키는 한 번만 반환되므로 BLOCKVECTRA_API_KEY에 저장하세요. 프로그래밍 방식 가입 가이드 따라하기 →

AI 에이전트가 BlockVectra를 직접 사용할 수 있나요?

네, 가능합니다. 에이전트는 사람과 동일한 공개 JSON-RPC 및 Data API를 동일한 문서와 요금으로 사용합니다. 문서 MCP 서버와 기계 판독 가능한 파일은 키가 필요하지 않습니다. 연결 방법 보기 →