avalanche-mcp-server

Instalación

Alojado: no hay nada que instalar. Misma forma que el build.avax.network/api/mcp de Ava Labs: un endpoint HTTP Streamable público, sin clave API.

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

Ejecuta /mcp en Claude Code para verificar: deberías ver avalanche · 41 herramientas.

Related MCP server: Somnia MCP Server

Qué hace

Pregunta en lenguaje natural; el agente elige las herramientas y cita sus fuentes.

› 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

Otras cosas que puedes preguntar desde el primer día:

• "Planifica una L1 empresarial con permisos en Fuji con cinco validadores y luego genera el genesis."

• "Explica la precompilación NativeMinter y cómo habilitarla después del lanzamiento con upgrade.json."

• "Envía un mensaje desde Fuji C-Chain a Dispatch con Teleporter, con configuración de relayer."

• "¿Qué ACPs están activados y qué cambia ACP-176 sobre el gas?"

• "Mi CLI dice subnet not tracked cuando llamo al RPC. ¿Qué está mal?"

Capacidades

41 herramientas, todas de solo lectura. Nada firma ni transmite transacciones.

Además, recursos MCP (avax://docs/{path}, avax://guides/{name}, avax://networks) y prompts (avalanche_launch_l1, avalanche_deploy_contract, avalanche_icm_bridge, avalanche_learn). La lista completa de herramientas está en avalanche-mcp.dev/#tools o mediante tools/list.

Verificado, no adivinado

Los hechos que los modelos suelen equivocar están fijados en el código y verificados contra la documentación: la tarifa base mínima de C-Chain es 1 wei desde Fortuna (ACP-176), no 25 nAVAX; subnet-evm y icm-contracts ahora viven en avalanchego/graft y icm-services; Helicon es solo para Fuji a partir de agosto de 2026. Cada respuesta incluye la URL de build.avax.network o GitHub de la que proviene.

Fuentes de conocimiento

El índice se construye con npm run build-index a partir de repositorios oficiales y se incluye dentro del paquete, por lo que la primera búsqueda funciona sin conexión:

avax_list_topics informa de la fecha de construcción del índice para que el agente sepa lo actualizado que está; avax_fetch_live_doc obtiene la versión actual de cualquier página cuando eso importa. Las cadenas con forma de credencial en los ejemplos de documentación se redactan en el momento de la construcción.

Configuración

No se requiere configuración. Variables de entorno opcionales (modo local):

Autoalojamiento

Ejecuta el transporte HTTP en cualquier lugar donde se ejecute Node:

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

O móntalo en cualquier runtime estándar web: manejadores de rutas de Next.js, Cloudflare Workers, Hono:

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

Así es exactamente como avalanche-mcp.dev lo sirve (fuente). Las respuestas son JSON sin estado con CORS abierto, por lo que los clientes basados en navegador también funcionan.

Funciona con los MCP oficiales de Avalanche

El MCP alojado de Ava Labs está siempre actualizado para la búsqueda de Builder Hub, consulta de CLI / RPC y runbooks; este servidor añade conocimiento sin conexión, ACPs y actualizaciones estructurados, herramientas EVM en vivo y flujos de trabajo de extremo a extremo. Se componen:

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 ya hace de proxy del servidor alojado desde dentro de este, por lo que un solo registro cubre la mayoría de las configuraciones.

Desarrollo

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

Extenderlo es un archivo por cada cosa: guías seleccionadas en src/knowledge/guides.ts, el registro de redes en src/config/networks.ts, la línea de tiempo de actualizaciones en src/knowledge/upgrades.ts, nuevas fuentes en scripts/build-index.ts.

Licencia

MIT. Avalanche MCP es un proyecto independiente construido por la comunidad y no está afiliado ni respaldado por Ava Labs ni por la Avalanche Foundation. Avalanche y la marca Avalanche son marcas comerciales de sus respectivos propietarios.