{"_id":"@dedanzi/avalanche-mcp-server","_rev":"2-e7c55792a731cb6dbe3e7e80f7bb1dc3","name":"@dedanzi/avalanche-mcp-server","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@dedanzi/avalanche-mcp-server","version":"0.1.0","keywords":["avalanche","mcp","model-context-protocol","icm","ictt","l1","blockchain"],"author":"","license":"MIT","_id":"@dedanzi/avalanche-mcp-server@0.1.0","maintainers":[{"name":"dedanzi","email":"mzidanfatonie@gmail.com"}],"bin":{"avalanche-mcp-server":"dist/index.js"},"dist":{"shasum":"34fa6a5a28a466f93fab8e587945d97cf89d55ba","tarball":"https://registry.npmjs.org/@dedanzi/avalanche-mcp-server/-/avalanche-mcp-server-0.1.0.tgz","fileCount":40,"integrity":"sha512-DXj6AmMJ+jvg3bDadXF/nBvJzaBJT0hWw4HnNCSzL1CZuiB+7+pNr6XQqMx+GHSy2PNfa/dT7OkJWzjUZwtV+g==","signatures":[{"sig":"MEUCIQCTV25QR8a/hODITmR/sqs3NSMQcGGhkdmGMZh8djr8cAIgThGlzZrfUagU2c9OviQHf2VCoqszUwtBAUH36wIt0Lc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":77020},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"2d13eac20b4f766793a1ef7f3c805fcb931034e8","scripts":{"dev":"tsx src/index.ts","lint":"eslint src --ext .ts","test":"vitest run","build":"tsc","start":"node dist/index.js","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"dedanzi","email":"mzidanfatonie@gmail.com"},"_npmVersion":"10.9.4","description":"MCP server for live Avalanche network data — L1 stats, ICM messages, ICTT transfers, validator info, and L1 scaffolding","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.0","axios":"^1.7.0","ethers":"^6.13.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","eslint":"^8.57.0","vitest":"^1.6.0","typescript":"^5.4.0","@types/node":"^20.0.0","@typescript-eslint/parser":"^7.0.0","@typescript-eslint/eslint-plugin":"^7.0.0"},"_npmOperationalInternal":{"tmp":"tmp/avalanche-mcp-server_0.1.0_1777780823019_0.4993250329644714","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@dedanzi/avalanche-mcp-server","version":"0.1.1","description":"MCP server for live Avalanche network data - L1 stats, ICM messages, ICTT transfers, validator info, and L1 scaffolding","main":"dist/index.js","bin":{"avalanche-mcp-server":"dist/index.js"},"publishConfig":{"access":"public"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","test":"vitest run","test:watch":"vitest","lint":"eslint src --ext .ts","prepublishOnly":"npm run build"},"keywords":["avalanche","mcp","model-context-protocol","icm","ictt","l1","blockchain"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","axios":"^1.7.0","ethers":"^6.13.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^20.0.0","tsx":"^4.0.0","typescript":"^5.4.0","vitest":"^1.6.0","eslint":"^8.57.0","@typescript-eslint/eslint-plugin":"^7.0.0","@typescript-eslint/parser":"^7.0.0"},"engines":{"node":">=18"},"_id":"@dedanzi/avalanche-mcp-server@0.1.1","gitHead":"5c20d0084744fb3f82560a38135170302cbac9c9","types":"./dist/index.d.ts","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-izMQfXCJ0oVH+WjSvKsRk6lkDwgzwWOFa8PFbt5yPVxp2Io5FgNsxqAtN/t6Noj/6cvIfPQFUu4M8UWlzeGW8w==","shasum":"27c5fa89a78dde5463b79d95ef1b9055537373a1","tarball":"https://registry.npmjs.org/@dedanzi/avalanche-mcp-server/-/avalanche-mcp-server-0.1.1.tgz","fileCount":40,"unpackedSize":77547,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCV6hSQFzVdoNbZoCOiIXCE7mhAI/jS58Z/raOBC1UHywIhANTsgIxIAvcbK3fSAw1EcIAZoEMzFqwtPxXt0qXoBg6c"}]},"_npmUser":{"name":"dedanzi","email":"mzidanfatonie@gmail.com"},"directories":{},"maintainers":[{"name":"dedanzi","email":"mzidanfatonie@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/avalanche-mcp-server_0.1.1_1777781291831_0.11714974653328913"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-03T04:00:22.937Z","modified":"2026-05-03T04:08:12.135Z","0.1.0":"2026-05-03T04:00:23.158Z","0.1.1":"2026-05-03T04:08:12.004Z"},"license":"MIT","keywords":["avalanche","mcp","model-context-protocol","icm","ictt","l1","blockchain"],"description":"MCP server for live Avalanche network data - L1 stats, ICM messages, ICTT transfers, validator info, and L1 scaffolding","maintainers":[{"name":"dedanzi","email":"mzidanfatonie@gmail.com"}],"readme":"# @dedanzi/avalanche-mcp-server\n\n[![npm version](https://img.shields.io/npm/v/@dedanzi/avalanche-mcp-server)](https://www.npmjs.com/package/@dedanzi/avalanche-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Retro9000](https://img.shields.io/badge/Retro9000-Tooling-red)](https://retro9000.avax.network)\n\nMCP server that gives AI agents live access to Avalanche network data - L1 stats, ICM messages, ICTT transfers, validator info, and L1 deployment scaffolding.\n\nPart of the [Avalanche Developer AI Toolkit](https://github.com/mzf11125/avalanche_agent_skills).\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"avalanche\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dedanzi/avalanche-mcp-server\"],\n      \"env\": {\n        \"AVACLOUD_API_KEY\": \"your-key-here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You can now ask:\n- *\"What are the most active Avalanche L1s right now?\"*\n- *\"Check the status of ICM message 0x1234...\"*\n- *\"Generate a genesis.json for my new L1 with chain ID 12345\"*\n- *\"Is validator NodeID-XXX active on my subnet?\"*\n\n### Run Directly\n\n```bash\nnpx @dedanzi/avalanche-mcp-server\n```\n\n### Install Globally\n\n```bash\nnpm install -g @dedanzi/avalanche-mcp-server\navalanche-mcp-server\n```\n\n## Getting an AvaCloud API Key\n\nAll 13 tools work without an API key using public endpoints. An AvaCloud API key unlocks higher rate limits and additional data fields on network, ICM, and ICTT tools.\n\n1. Go to [avacloud.io](https://avacloud.io) and sign up for a free account\n2. In the AvaCloud console, navigate to **Settings** > **API Keys**\n3. Click **Create API Key**, give it a name, and copy the key\n4. Set it as `AVACLOUD_API_KEY` in your MCP config env (see Quick Start above) or in a `.env` file\n\nThe free tier includes rate limits sufficient for development and testing.\n\n## Tools (13 total)\n\n### Network\n\n| Tool | Description |\n|------|-------------|\n| `get_network_overview` | Avalanche network health snapshot |\n| `get_avalanche_l1s` | List live Avalanche L1s |\n| `get_l1_stats` | Stats for a specific L1 (TPS, addresses, validators) |\n| `get_validator_info` | Validator status and uptime |\n\n### ICM (Interchain Messaging)\n\n| Tool | Description |\n|------|-------------|\n| `get_icm_messages` | Recent ICM messages with filtering |\n| `check_icm_message` | Delivery status of a specific message |\n| `get_icm_stats` | ICM volume and delivery stats |\n\n### ICTT (Interchain Token Transfer)\n\n| Tool | Description |\n|------|-------------|\n| `get_ictt_transfers` | Recent token bridge transfers |\n| `get_ictt_tokens` | ICTT-deployed tokens and their remotes |\n\n### Developer Utilities\n\n| Tool | Description |\n|------|-------------|\n| `scaffold_l1_deployment` | Generate genesis.json + Hardhat config for a new L1 |\n| `get_contract_addresses` | Official Avalanche contract addresses |\n| `decode_warp_message` | Decode a raw Warp message payload |\n| `check_avacloud_status` | AvaCloud service health |\n\n## Configuration\n\n```env\n# Optional - higher rate limits and additional data (get key at avacloud.io)\nAVACLOUD_API_KEY=\n\n# Optional - override default RPC endpoints\nAVAX_MAINNET_RPC=https://api.avax.network/ext/bc/C/rpc\nAVAX_FUJI_RPC=https://api.avax-test.network/ext/bc/C/rpc\n\n# Optional\nDEFAULT_NETWORK=mainnet\nREQUEST_TIMEOUT_MS=10000\n```\n\n## Example Interactions\n\n**Check ICM message delivery:**\n> \"Check if ICM message 0xabc123... was delivered\"\n\n**Scaffold a new L1:**\n> \"Generate deployment files for my L1 called 'GameChain' with chain ID 99999, native token GAME, ICM enabled\"\n\n**Monitor validators:**\n> \"Is NodeID-5mb46qkSBj81k9g9e1af1uAGbFjGcr1LL active on subnet 2D9GkvLMBuH4...\"\n\n## Development\n\n```bash\ngit clone https://github.com/mzf11125/avalanche-mcp-server\ncd avalanche-mcp-server\nnpm install\nnpm run dev    # run with tsx (no build needed)\nnpm run build  # compile to dist/\nnpm test       # run tests\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}