DevX Multichain Balances

io.github.devx-agentPublished by GitHub account devx-agentv2.1.0Updated Nov 6, 2026

Balances on 7 EVM chains, Solana, Tron: free one-chain lookup; full call 0.002 USDC via x402.

VerifiedStreamable HTTPWeb executableDatabasesFinance

Overview

AI-generated overview

Read-only wallet balance lookup across 7 EVM chains, Solana and Tron, with a free single-chain tool and a paid multichain call.

What you can do
  • Look up one address's native coin plus USDC (USDT on Tron) balance on a single chain, free and read-only, at the latest block.
  • Get instructions on how to buy the full multichain call, which covers major tokens across 7 EVM chains, Solana and Tron plus custom tokens, for 0.002 USDC via x402.
  • Query addresses on ethereum, base, arbitrum, optimism, polygon, avalanche, bsc, solana and tron.
When to use it
Useful when an assistant needs to answer what a wallet holds without the user running their own RPC infrastructure, and a free single-chain check is enough. The paid multichain path is for cases needing many chains and major tokens in one call.
Requirements
Remote endpoint over streamable HTTP needs no credentials. The local npm package runs via npx (Node.js) and, for the paid multichain call, needs an X402_PRIVATE_KEY environment variable holding a Base wallet with USDC; without it the paid call only returns a quote. Network access to the hosted API is required.
Before you install
The paid multichain call costs 0.002 USDC per call, signed with the wallet key in X402_PRIVATE_KEY; use a dedicated low-balance wallet. Since v2 the package is a thin client and the addresses you query are sent to the hosted API. Results come from public RPC nodes, cover only a fixed token list plus associated Solana token accounts, and stablecoin totals are face value, not market price.

Installation

In SourceWeft

  1. Open DevX Multichain Balances in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.devx-agent%2Fmultichain-balances/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "devx-multichain-balances": {
      "type": "http",
      "url": "https://wallet-balances.nextill-pos.workers.dev/mcp"
    }
  }
}

README

DevX Multichain Balances

One call, nine chains. Native coin plus the major tokens for an address on Base, Ethereum, Arbitrum, Optimism, Polygon, Avalanche, BNB Chain, Solana and Tron. It is built for AI agents and apps that need to answer "what does this wallet hold?" without running their own RPC setup.

Everything here is read-only. It never asks for keys and never moves funds.

WhatCost
CLI / stdio MCP devx-multichain-balances (v2)Client for the hosted API below. One chain (native + USDC, USDT on Tron) is free; all / multichain_balances is the paid call, paid from your own wallet keyfree / 0.002 USDC
Remote MCP https://wallet-balances.nextill-pos.workers.dev/mcpbasic_balance (one chain, free) + multichain_balances_infofree
HTTP API GET /v1/balancesUp to 3 addresses (one EVM, one Solana, one Tron) → native + USDC, USDT, DAI, EURC, bridged USDC, WETH, WBTC/cbBTC per EVM chain; SOL + USDC/USDT (SPL); TRX + USDT/USDC (TRC-20); plus up to 10 custom tokens (ERC-20, SPL mint, TRC-20). Block numbers/slots included, stablecoin face-value total0.002 USDC via x402 on Base

Live: https://wallet-balances.nextill-pos.workers.dev · token list: /tokens.json

CLI

sh
npx devx-multichain-balances 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM          # free: SOL + USDC on Solananpx devx-multichain-balances TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G                      # free: TRX + USDT on Tronnpx devx-multichain-balances 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain arbitrum   # free: ETH + USDC on Arbitrum
# paid, 0.002 USDC per call: every matching chain, all majors, custom tokensexport X402_PRIVATE_KEY=0x...   # a Base wallet holding a little USDC (use a dedicated low-balance wallet)npx devx-multichain-balances all 0xd8dA...6045,9WzD...AWWM --chains base,ethereum,solana

How paying works: the CLI asks the API for its x402 quote, checks that it is USDC on Base, goes to 0xB3cD…f247 and is at or under --max-usd (default 0.01), then signs a gasless EIP-3009 authorization with your key via @x402/fetch. The key stays on your machine. Without a key, all prints the quote, pays nothing and exits with code 2. Since v2.0.0 the package is a thin client. It no longer ships the balance-reading code, and the addresses you query are sent to the hosted API.

MCP

Claude Desktop / Cursor (stdio):

json
{ "mcpServers": { "multichain-balances": { "command": "npx", "args": ["-y", "devx-multichain-balances", "mcp"], "env": { "X402_PRIVATE_KEY": "0x... (optional, enables the paid tool)" } } } }

Or remote (streamable HTTP): https://wallet-balances.nextill-pos.workers.dev/mcp (free tool + info only)

Tools: basic_balance (free), multichain_balances (0.002 USDC per call, pays only if X402_PRIVATE_KEY is set and never above 0.01 USDC, otherwise returns the quote), multichain_balances_info.

Paid hosted call (x402)

GET https://wallet-balances.nextill-pos.workers.dev/v1/balances?address=0x...,<solana>,<T...>[&chains=base,ethereum,solana,tron][&tokens=base:0xToken,solana:<mint>,tron:<T...>]
  • Answers 402 with an x402 v1 body (X-PAYMENT, network base) and a v2 PAYMENT-REQUIRED header (PAYMENT-SIGNATURE, eip155:8453). Both work. POST with a JSON body works too.
  • 2000 atomic USDC (0.002 USDC) to 0xB3cDDccEe6B150c8efFD55B961afc0Ecefe7f247, settled through the Coinbase CDP facilitator, listed in the CDP x402 Bazaar.
  • Settled only after a result is produced. Bad input, or every chain's RPC failing, is not charged. Failed chains are listed in summary.chains_failed.
  • chains defaults to every chain that matches the addresses you gave (evm = the 7 EVM chains).

Limits

  • It does not discover arbitrary tokens. It checks a fixed, verified list (see /tokens.json), and you can pass extra tokens yourself.
  • On Solana it reads the owner's associated token accounts (where wallets normally keep tokens). Tokens held in other token accounts are not counted.
  • The stablecoin total is face value (1 token = 1 unit), not a market price.
  • Data comes from free public RPC nodes (publicnode.com with fallbacks: mainnet-beta / Tatum gateway for Solana, TronGrid for Tron). Identical calls within 20 s may be served from a short per-instance cache (cache.hit).

OpenAPI: /openapi.json · Terms: /terms

Related DevX tools

Layout

  • cli/: npm package devx-multichain-balances (CLI + stdio MCP client for the hosted API), npm test
  • worker/: the Cloudflare Worker behind the hosted API (npm run build, npm test)

MIT. Made by DevX · [email protected]

Source: README.md at commit 644e6ad

Tools

2

basic_balance

Free, read-only: native coin + USDC (USDT on Tron) balance of one address on one chain (ethereum, base, arbitrum, optimism, polygon, avalanche, bsc, solana, tron), live at the latest block. Address: EVM 0x, Solana base58 or Tron T...

Parameterschainaddressrequired

multichain_balances_info

How to buy the full call (native + USDC/USDT/DAI/EURC/bridged USDC/WETH/WBTC on 7 EVM chains, SOL + USDC/USDT on Solana, TRX + USDT on Tron, + custom tokens) via x402 for 0.002 USDC. Does not pay.

Takes no parameters.

Version history

1
  1. v2.1.0LatestOct 30, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts