avalanche-mcp-server

설치

호스팅 — 설치할 것이 없습니다. Ava Labs의 build.avax.network/api/mcp와 동일한 형태: API 키가 필요 없는 공개 Streamable HTTP 엔드포인트입니다.

claude mcp add avalanche --transport http https://avalanche-mcp.dev/mcp

Claude Code에서 /mcp를 실행하여 확인하세요 — avalanche · 41 tools가 보일 것입니다.

Related MCP server: Somnia MCP Server

기능

자연어로 질문하면 에이전트가 도구를 선택하고 출처를 인용합니다.

› What changes in the Helicon upgrade for my C-Chain indexer?

⏺ avax_upgrade_lookup(query: "Helicon")
⏺ avax_acp_lookup(query: "ACP-194")
⏺ avax_get_doc(content/docs/primary-network/helicon-upgrade.mdx)

Helicon (AvalancheGo v1.15.0-fuji) is live on Fuji since 2026-07-28; mainnet is not
scheduled yet. ACP-194 Continuous Execution decouples consensus from execution, so a
block's state root settles after a τ delay (~5 s) — don't treat "latest" as executed
state. ACP-283 makes the minimum gas price dynamic, so never hardcode a fee floor.

Sources: build.avax.network/docs/primary-network/helicon-upgrade
         build.avax.network/docs/acps/194-continuous-execution

첫날에 물어볼 수 있는 다른 질문들:

• "Fuji에 검증인 5명으로 구성된 허가형 엔터프라이즈 L1을 계획하고, genesis를 생성해 줘."

• "NativeMinter 프리컴파일을 설명하고, launch 후 upgrade.json으로 활성화하는 방법을 알려 줘."

• "Teleporter로 Fuji C-Chain에서 Dispatch로 메시지를 보내고, relayer를 설정해 줘."

• "어떤 ACP가 활성화되어 있고, ACP-176이 가스에 대해 무엇을 바꾸나요?"

• "RPC에 접속할 때 CLI가 subnet not tracked라고 표시됩니다. 무엇이 문제인가요?"

기능 목록

41개 도구, 모두 읽기 전용. 트랜잭션에 서명하거나 브로드캐스트하지 않습니다.

추가로 MCP 리소스(avax://docs/{path}, avax://guides/{name}, avax://networks)와 프롬프트(avalanche_launch_l1, avalanche_deploy_contract, avalanche_icm_bridge, avalanche_learn)가 포함됩니다. 전체 도구 목록은 avalanche-mcp.dev/#tools 또는 tools/list에서 확인할 수 있습니다.

검증된 정보, 추측이 아닌

모델이 자주 틀리는 사실은 코드에 고정되어 문서와 대조됩니다: Fortuna(ACP-176) 이후 C-Chain 최소 기본 수수료는 25 nAVAX가 아닌 1 wei입니다; subnet-evm과 icm-contracts는 이제 avalanchego/graft와 icm-services에 있습니다; Helicon은 2026년 8월 기준 Fuji 전용입니다. 모든 답변에는 출처가 된 build.avax.network 또는 GitHub URL이 포함됩니다.

지식 소스

인덱스는 npm run build-index로 공식 저장소에서 빌드되어 패키지에 포함되므로 첫 검색도 오프라인에서 작동합니다:

avax_list_topics는 인덱스 빌드 날짜를 보고하여 에이전트가 데이터의 최신성을 알 수 있게 합니다; avax_fetch_live_doc는 중요한 경우 모든 페이지의 현재 버전을 가져옵니다. 문서 예제의 자격 증명 형태 문자열은 빌드 시점에 삭제됩니다.

구성

구성이 필요 없습니다. 선택적 환경 변수(로컬 모드):

셀프 호스팅

Node가 실행되는 모든 곳에서 HTTP 전송을 실행하세요:

npx -y avalanche-mcp-server --http        # POST http://localhost:3333/mcp  (PORT to change)

또는 모든 웹 표준 런타임 — Next.js 라우트 핸들러, Cloudflare Workers, Hono — 에 마운트하세요:

import { handleMcpRequest } from "avalanche-mcp-server";
export const POST = (req: Request) => handleMcpRequest(req);

이것이 바로 avalanche-mcp.dev가 서비스를 제공하는 방식입니다 (소스). 응답은 CORS가 열린 무상태 JSON이므로 브라우저 기반 클라이언트도 작동합니다.

공식 Avalanche MCP와 함께 사용

Ava Labs의 호스팅 MCP는 Builder Hub 검색, CLI / RPC 조회 및 런북에 대해 항상 최신 상태입니다; 이 서버는 오프라인 지식, 구조화된 ACP 및 업그레이드, 실시간 EVM 도구, 종단 간 워크플로우를 추가합니다. 이들은 함께 구성됩니다:

claude mcp add avalanche          --transport http https://avalanche-mcp.dev/mcp
claude mcp add avalanche-hosted   --transport http https://build.avax.network/api/mcp
claude mcp add avalanche-chainkit -- npx -y @avalanche-sdk/chainkit mcp-server
claude mcp add avalanche-avacloud -- npx -y @avalabs/avacloud-sdk mcp-server --apikey $AVACLOUD_API_KEY

avax_hosted_call은 이미 이 서버 내부에서 호스팅 서버를 프록시하므로, 단일 등록으로 대부분의 설정을 처리할 수 있습니다.

개발

git clone https://github.com/Eelvanpsd/Avalanche-mcp.git && cd Avalanche-mcp
npm install && npm run build       # the index ships in the repo
npm run dev                        # stdio server via tsx
npm run inspect                    # MCP Inspector UI
npx tsx scripts/smoke.ts           # end-to-end tool check over stdio
REFRESH=1 npm run build-index      # re-download sources and rebuild the index

확장은 파일 하나씩입니다: 큐레이티드 가이드는 src/knowledge/guides.ts, 네트워크 레지스트리는 src/config/networks.ts, 업그레이드 타임라인은 src/knowledge/upgrades.ts, 새 소스는 scripts/build-index.ts에 추가합니다.

라이선스

MIT. Avalanche MCP는 독립적인 커뮤니티 빌드 프로젝트이며 Ava Labs 또는 Avalanche Foundation과 제휴하거나 보증하지 않습니다. Avalanche 및 Avalanche 마크는 각 소유자의 상표입니다.