Avalanche AVAX MCP
by Airpote · remote · no sign-in to list tools · v1.0.1 · published by GitHub user Airpote
Search and retrieve Avalanche blockchain documentation for building on AVAX.
48 tools: 1 do something that can't be undone, 5 change things and 42 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone1Claude Code: ask: see these tools
- Changes things5Claude Code: ask: see these tools
- Only reads42Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http avalanche-docs https://build.avax.network/api/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
48 tools
Can't be undone 1Claude Code: ask
build_planGenerate a step-by-step, copy-pasteable runbook for an Avalanche operation — Builder Console (no-code) path plus the equivalent platform-cli / SDK / interchain-kit commands.No findings
Why it is in this group
- The description's first verb is "generate": a word for a change.
- The input addresses people (input.to): what it sends cannot be taken back.
Description, as the server wrote it Generate a step-by-step, copy-pasteable runbook for an Avalanche operation — Builder Console (no-code) path plus the equivalent platform-cli / SDK / interchain-kit commands. Read-only: never signs. operation: create-l1 (launch an L1); use ictt or interchain-kit for any CROSS-CHAIN / interoperability work — bridging tokens, sending cross-chain (ICM / Teleporter / Warp) messages, or connecting your L1 to C-Chain or other L1s (interchain-kit also lets you iterate locally first); validator-manager; staking; transfer.
Changes things 5Claude Code: ask
chain_statsOn-chain statistics via the query gateway, which picks the most accurate live source PER FIELD and stamps it (sources/warnings in the response).No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it On-chain statistics via the query gateway, which picks the most accurate live source PER FIELD and stamps it (sources/warnings in the response). target=chain: tx count/gas/fees/active senders/avg gas price over a recent window (window=recent, `hours`, max 720h = 30 days) OR a time-series (window=series, `days`, max 365). target=contract: per-contract tx/sender/gas totals (`days`, max 365 — use this for contract activity beyond 30 days). target=network: current P-chain validator snapshot. IMPORTANT: relay any `warnings` notes to the user verbatim-in-substance (e.g. gas coverage windows or accuracy caveats) — never present a flagged value as exact. Note: C-Chain gasUsed is gas-target-regulated, so daily gas is ~stable even as tx count varies — expected, not an error.
console_flowBuilder Console flow knowledge.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it Builder Console flow knowledge. Call with NO `flow` to list every flow (summaries + deep-links); call with a `flow` key to explain it (ordered steps, equivalent CLI, whether it signs transactions, deep-link). Flows: create-l1, convert-to-l1, validator-manager, ictt, faucet, multisig, staking, transfers, interchain-kit-local.
console_linkReturn a deep-link into a specific Builder Console flow (create-l1, convert-to-l1, validator-manager, ictt, faucet, multisig, staking, transfers, interchain-kit-local).No findings
Why it is in this group
- The name "console_link" says "link": a word for a change.
Description, as the server wrote it Return a deep-link into a specific Builder Console flow (create-l1, convert-to-l1, validator-manager, ictt, faucet, multisig, staking, transfers, interchain-kit-local). For faucet on mainnet, returns a note that there is no mainnet faucet.
info_is_bootstrappedCheck whether a given chain has finished bootstrapping on the node.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it Check whether a given chain has finished bootstrapping on the node.
onchain_activityTime-windowed on-chain activity.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it Time-windowed on-chain activity. scope=chain/address returns the transaction COUNT over the last `hours` (max 720h = 30 days; for longer windows use chain_stats series or onchain_query day-based ops) plus a recent sample. For a token/contract use scope=token (transfers). scope=primary covers P/X-chain and DEFAULTS to P-Chain when no blockchainId is given (so "last N P-chain transactions" just works). A value with no scope defaults to address.
Only reads 42Claude Code: allow
acp_listList Avalanche Community Proposals with structured fields, optionally filtered by status (Activated, Implementable, Proposed, Stale, Withdrawn) or track (Standards, Best Practices,…No findings
Why it is in this group
- The name "acp_list" says "list": a word for reading.
Description, as the server wrote it List Avalanche Community Proposals with structured fields, optionally filtered by status (Activated, Implementable, Proposed, Stale, Withdrawn) or track (Standards, Best Practices, Meta, Subnet).
acp_lookupLook up Avalanche Community Proposals (ACPs) by number, title, or topic.No findings
Why it is in this group
- The name "acp_lookup" says "lookup": a word for reading.
Description, as the server wrote it Look up Avalanche Community Proposals (ACPs) by number, title, or topic. When a number is provided the structured ACP record is returned (title, status, track, authors, cross-references).
avalanche_docs_fetchCompatibility alias for docs_fetch.No findings
Why it is in this group
- The name "avalanche_docs_fetch" says "fetch": a word for reading.
Description, as the server wrote it Compatibility alias for docs_fetch. Prefer docs_fetch for new clients.
avalanche_docs_list_sectionsCompatibility alias for docs_list_sections.No findings
Why it is in this group
- The name "avalanche_docs_list_sections" says "list": a word for reading.
Description, as the server wrote it Compatibility alias for docs_list_sections. Prefer docs_list_sections for new clients.
avalanche_docs_searchCompatibility alias for docs_search.No findings
Why it is in this group
- The name "avalanche_docs_search" says "search": a word for reading.
Description, as the server wrote it Compatibility alias for docs_search. Prefer docs_search for new clients.
blockchain_get_contract_infoCompatibility alias for onchain_lookup contract metadata.No findings
Why it is in this group
- The name "blockchain_get_contract_info" says "get": a word for reading.
Description, as the server wrote it Compatibility alias for onchain_lookup contract metadata. Prefer onchain_lookup for new clients.
blockchain_get_native_balanceCompatibility alias for onchain_lookup address balances.No findings
Why it is in this group
- The name "blockchain_get_native_balance" says "get": a word for reading.
Description, as the server wrote it Compatibility alias for onchain_lookup address balances. Prefer onchain_lookup for new clients.
blockchain_lookup_addressCompatibility alias for onchain_lookup address details.No findings
Why it is in this group
- The name "blockchain_lookup_address" says "lookup": a word for reading.
Description, as the server wrote it Compatibility alias for onchain_lookup address details. Prefer onchain_lookup for new clients.
blockchain_lookup_chainLook up a blockchain by its ID — name, VM type, and Subnet/L1.No findings
Why it is in this group
- The name "blockchain_lookup_chain" says "lookup": a word for reading.
Description, as the server wrote it Look up a blockchain by its ID — name, VM type, and Subnet/L1.
blockchain_lookup_subnetLook up a Subnet / L1 by its ID — validators, chains, and configuration.No findings
Why it is in this group
- The name "blockchain_lookup_subnet" says "lookup": a word for reading.
Description, as the server wrote it Look up a Subnet / L1 by its ID — validators, chains, and configuration.
blockchain_lookup_transactionLook up a transaction by hash on Avalanche (C-Chain, P-Chain, or X-Chain).No findings
Why it is in this group
- The name "blockchain_lookup_transaction" says "lookup": a word for reading.
Description, as the server wrote it Look up a transaction by hash on Avalanche (C-Chain, P-Chain, or X-Chain). Supports 0x format (C-Chain) and CB58 format (P/X-Chain).
blockchain_lookup_validatorLook up a validator by node ID — stake, uptime, delegation info.No findings
Why it is in this group
- The name "blockchain_lookup_validator" says "lookup": a word for reading.
Description, as the server wrote it Look up a validator by node ID — stake, uptime, delegation info.
cli_lookup_commandLook up Avalanche CLI, Platform CLI, and tmpnet command guidance in the docs.No findings
Why it is in this group
- The name "cli_lookup_command" says "lookup": a word for reading.
Description, as the server wrote it Look up Avalanche CLI, Platform CLI, and tmpnet command guidance in the docs. Returns cited command references and task docs.
docs_fetchFetch a specific documentation page as markdownNo findings
Why it is in this group
- The name "docs_fetch" says "fetch": a word for reading.
Description, as the server wrote it Fetch a specific documentation page as markdown
docs_list_sectionsList available documentation sections and their page countsNo findings
Why it is in this group
- The name "docs_list_sections" says "list": a word for reading.
Description, as the server wrote it List available documentation sections and their page counts
docs_searchSearch body-level chunks across Avalanche documentation, academy courses, integrations, and blog posts.No findings
Why it is in this group
- The name "docs_search" says "search": a word for reading.
Description, as the server wrote it Search body-level chunks across Avalanche documentation, academy courses, integrations, and blog posts. Returns source citations and matching excerpts.
info_acpsGet information about Avalanche Community Proposals (ACPs), including their status and vote counts.No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it Get information about Avalanche Community Proposals (ACPs), including their status and vote counts.
info_get_blockchain_idGet the CB58-encoded blockchain ID for a given blockchain alias (e.g., "X", "P", "C").No findings
Why it is in this group
- The name "info_get_blockchain_id" says "get": a word for reading.
Description, as the server wrote it Get the CB58-encoded blockchain ID for a given blockchain alias (e.g., "X", "P", "C").
info_get_network_idGet the numeric ID of the Avalanche network this node is participating in.No findings
Why it is in this group
- The name "info_get_network_id" says "get": a word for reading.
Description, as the server wrote it Get the numeric ID of the Avalanche network this node is participating in.
info_get_network_nameGet the human-readable name of the Avalanche network this node is participating in.No findings
Why it is in this group
- The name "info_get_network_name" says "get": a word for reading.
Description, as the server wrote it Get the human-readable name of the Avalanche network this node is participating in.
info_get_node_versionGet the version of the node, including the database version, git commit, and API compatibility info.No findings
Why it is in this group
- The name "info_get_node_version" says "get": a word for reading.
Description, as the server wrote it Get the version of the node, including the database version, git commit, and API compatibility info.
info_get_tx_feeGet the current transaction fees for the network, returned in both nAVAX and AVAX.No findings
Why it is in this group
- The name "info_get_tx_fee" says "get": a word for reading.
Description, as the server wrote it Get the current transaction fees for the network, returned in both nAVAX and AVAX.
info_peersGet a list of peers this node is connected to.No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it Get a list of peers this node is connected to. Optionally filter by specific NodeIDs.
onchain_lookupPRIMARY lookup tool — use this (not raw RPC) to resolve/describe any on-chain identifier in one call: an EVM address (native + token balances, recent txs, contract metadata + isCon…No findings
Why it is in this group
- The name "onchain_lookup" says "lookup": a word for reading.
Description, as the server wrote it PRIMARY lookup tool — use this (not raw RPC) to resolve/describe any on-chain identifier in one call: an EVM address (native + token balances, recent txs, contract metadata + isContract), a contract/token (metadata + deployment + recent transfers), an NFT (collection + tokenId), a tx hash, a subnet ID, a NodeID validator, a P-/X-Chain account (P-…/X-… → P-Chain balance), or a chain name/id. Use this for any address balance / contract-info / token / identity question. `kind` auto-detects; network is inferred from P-/X-Chain prefixes. Backed by Glacier + P-Chain RPC.
onchain_queryPRIMARY tool for indexed on-chain stats/activity/totals — prefer this over raw RPC for chain data.No findings
Why it is in this group
- The name "onchain_query" says "query": a word for reading.
Description, as the server wrote it PRIMARY tool for indexed on-chain stats/activity/totals — prefer this over raw RPC for chain data. Each `op` is a backend-agnostic intent: the query gateway selects the most accurate live source per field (indexed DB / pre-aggregated metrics / Data API), stamps every field (`sources`), and flags any caveat (`warnings`) — relay warnings to the user, never present a flagged value as exact. Pick an `op` and pass its `params`; `chainId` is an allowlisted EVM chain (43114 C-Chain, 43113 Fuji, + L1s). Lookback: hour-based ops (chainStatsRecent/chainActivity/addressActivity) max 720h (30 days); day-based ops (chainStatsSeries/contractStats/chainGasTotal/protocolRanking/contractGasFlow/topUnknownContracts) max 365 days — use a day-based op for windows over 30 days. Ops: chainStatsRecent {chainId, hours≤720} — tx count/gas/fees/active senders/avg gas price over the last N hours; chainStatsSeries {chainId, days≤365, bucket: hour|day|week|month} — bucketed time-series of the same; addressActivity {chainId, address, hours≤720, limit≤100} — tx count + recent sample for an address in a window; chainActivity {chainId, hours≤720, limit≤100} — tx count + recent sample chain-wide in a window; contractStats {chainId, contract, days≤365} — tx/unique-sender/gas totals for a contract; protocolRanking {chainId, contracts[≤25], days≤365, orderBy: txCount|gasUsed|uniqueSenders|feesPaidAvax, dir: asc|desc, limit≤100} — rank a set of contracts; contractGasFlow {chainId, contract, days≤365, limit≤100} — gas received/given per counterparty; topUnknownContracts {chainId, exclude[≤25], days≤365, limit≤100} — top contracts by gas excluding a set; chainGasTotal {chainId, days≤365} OR {chainId, fromDate, toDate} — total tx/gas/fees over N days or a YYYY-MM-DD range (≤365d). Note: C-Chain gasUsed is gas-target-regulated → ~stable day-to-day even as txCount varies (expected, not a bug).
platform_get_balanceGet the AVAX balance of one or more P-Chain addressesNo findings
Why it is in this group
- The name "platform_get_balance" says "get": a word for reading.
Description, as the server wrote it Get the AVAX balance of one or more P-Chain addresses
platform_get_blockGet a P-Chain block by its block IDNo findings
Why it is in this group
- The name "platform_get_block" says "get": a word for reading.
Description, as the server wrote it Get a P-Chain block by its block ID
platform_get_block_by_heightGet a P-Chain block by its heightNo findings
Why it is in this group
- The name "platform_get_block_by_height" says "get": a word for reading.
Description, as the server wrote it Get a P-Chain block by its height
platform_get_blockchainsGet all blockchains that exist on the P-Chain (paginated; use limit/offset)No findings
Why it is in this group
- The name "platform_get_blockchains" says "get": a word for reading.
Description, as the server wrote it Get all blockchains that exist on the P-Chain (paginated; use limit/offset)
platform_get_current_supplyGet the current total supply of AVAX on a Subnet/L1No findings
Why it is in this group
- The name "platform_get_current_supply" says "get": a word for reading.
Description, as the server wrote it Get the current total supply of AVAX on a Subnet/L1
platform_get_current_validatorsGet the current validators of a Subnet/L1 (paginated; use limit/offset)No findings
Why it is in this group
- The name "platform_get_current_validators" says "get": a word for reading.
Description, as the server wrote it Get the current validators of a Subnet/L1 (paginated; use limit/offset)
platform_get_heightGet the current P-Chain block heightNo findings
Why it is in this group
- The name "platform_get_height" says "get": a word for reading.
Description, as the server wrote it Get the current P-Chain block height
platform_get_min_stakeGet the minimum staking amounts for validators and delegators on a Subnet/L1No findings
Why it is in this group
- The name "platform_get_min_stake" says "get": a word for reading.
Description, as the server wrote it Get the minimum staking amounts for validators and delegators on a Subnet/L1
platform_get_pending_validatorsGet the pending validators of a Subnet/L1 (paginated; use limit/offset)No findings
Why it is in this group
- The name "platform_get_pending_validators" says "get": a word for reading.
Description, as the server wrote it Get the pending validators of a Subnet/L1 (paginated; use limit/offset)
platform_get_staking_asset_idGet the asset ID of the token used for staking on a Subnet/L1No findings
Why it is in this group
- The name "platform_get_staking_asset_id" says "get": a word for reading.
Description, as the server wrote it Get the asset ID of the token used for staking on a Subnet/L1
platform_get_subnetsGet information about Subnets/L1s on the P-ChainNo findings
Why it is in this group
- The name "platform_get_subnets" says "get": a word for reading.
Description, as the server wrote it Get information about Subnets/L1s on the P-Chain
platform_get_total_stakeGet the total amount staked on a Subnet/L1No findings
Why it is in this group
- The name "platform_get_total_stake" says "get": a word for reading.
Description, as the server wrote it Get the total amount staked on a Subnet/L1
platform_get_txGet a P-Chain transaction by its transaction IDNo findings
Why it is in this group
- The name "platform_get_tx" says "get": a word for reading.
Description, as the server wrote it Get a P-Chain transaction by its transaction ID
platform_get_tx_statusGet the status of a P-Chain transactionNo findings
Why it is in this group
- The name "platform_get_tx_status" says "get": a word for reading.
Description, as the server wrote it Get the status of a P-Chain transaction
platform_get_utxosGet UTXOs that reference a given set of P-Chain addressesNo findings
Why it is in this group
- The name "platform_get_utxos" says "get": a word for reading.
Description, as the server wrote it Get UTXOs that reference a given set of P-Chain addresses
platform_get_validators_atGet the validators and their weights of a Subnet/L1 at a given P-Chain heightNo findings
Why it is in this group
- The name "platform_get_validators_at" says "get": a word for reading.
Description, as the server wrote it Get the validators and their weights of a Subnet/L1 at a given P-Chain height
rpc_lookup_methodLook up Avalanche RPC methods and API guides across C-Chain, P-Chain, X-Chain, Subnet-EVM, and node RPC docs.No findings
Why it is in this group
- The name "rpc_lookup_method" says "lookup": a word for reading.
Description, as the server wrote it Look up Avalanche RPC methods and API guides across C-Chain, P-Chain, X-Chain, Subnet-EVM, and node RPC docs.
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.0.1. Values in angle brackets are yours to fill in.
claude mcp add --transport http avalanche-docs https://build.avax.network/api/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__avalanche-docs__docs_search",
"mcp__avalanche-docs__docs_fetch",
"mcp__avalanche-docs__docs_list_sections",
"mcp__avalanche-docs__cli_lookup_command",
"mcp__avalanche-docs__rpc_lookup_method",
"mcp__avalanche-docs__acp_lookup",
"mcp__avalanche-docs__acp_list",
"mcp__avalanche-docs__avalanche_docs_search",
"mcp__avalanche-docs__avalanche_docs_fetch",
"mcp__avalanche-docs__avalanche_docs_list_sections",
"mcp__avalanche-docs__blockchain_lookup_transaction",
"mcp__avalanche-docs__blockchain_lookup_subnet",
"mcp__avalanche-docs__blockchain_lookup_chain",
"mcp__avalanche-docs__blockchain_lookup_validator",
"mcp__avalanche-docs__platform_get_height",
"mcp__avalanche-docs__platform_get_block",
"mcp__avalanche-docs__platform_get_block_by_height",
"mcp__avalanche-docs__platform_get_blockchains",
"mcp__avalanche-docs__platform_get_subnets",
"mcp__avalanche-docs__platform_get_current_validators",
"mcp__avalanche-docs__platform_get_pending_validators",
"mcp__avalanche-docs__platform_get_staking_asset_id",
"mcp__avalanche-docs__platform_get_min_stake",
"mcp__avalanche-docs__platform_get_total_stake",
"mcp__avalanche-docs__platform_get_balance",
"mcp__avalanche-docs__platform_get_utxos",
"mcp__avalanche-docs__platform_get_tx",
"mcp__avalanche-docs__platform_get_tx_status",
"mcp__avalanche-docs__platform_get_current_supply",
"mcp__avalanche-docs__platform_get_validators_at",
"mcp__avalanche-docs__info_get_node_version",
"mcp__avalanche-docs__info_get_network_id",
"mcp__avalanche-docs__info_get_network_name",
"mcp__avalanche-docs__info_get_blockchain_id",
"mcp__avalanche-docs__info_get_tx_fee",
"mcp__avalanche-docs__info_peers",
"mcp__avalanche-docs__info_acps",
"mcp__avalanche-docs__blockchain_get_native_balance",
"mcp__avalanche-docs__blockchain_get_contract_info",
"mcp__avalanche-docs__blockchain_lookup_address",
"mcp__avalanche-docs__onchain_lookup",
"mcp__avalanche-docs__onchain_query"
],
"ask": [
"mcp__avalanche-docs__info_is_bootstrapped",
"mcp__avalanche-docs__onchain_activity",
"mcp__avalanche-docs__chain_stats",
"mcp__avalanche-docs__build_plan",
"mcp__avalanche-docs__console_link",
"mcp__avalanche-docs__console_flow"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as avalanche-docs. Review it before you use it.
