DevX Token Snapshot

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

ERC-20 price, liquidity, pools, holder hints, risk flags on 7 EVM chains. Paid 0.003 USDC via x402.

VerifiedStreamable HTTPWeb executableDatabasesFinance

Overview

AI-generated overview

Read-only ERC-20 token lookup on 7 EVM chains: free basics, plus a paid snapshot with price, liquidity, pools, holder hints and risk flags.

What you can do
  • Read free token basics: name, symbol, decimals, total supply, proxy/owner presence and number of DEX pools found on seven EVM chains.
  • Get instructions on buying the full snapshot (USD price, liquidity, top pools, holder-concentration hints, risk flags) for 0.003 USDC on Base via x402.
  • The paid snapshot itself is available through the CLI or HTTP API, not through the remote MCP tools.
When to use it
Useful when an assistant needs a quick, keyless check of an ERC-20 token on Base, Ethereum, Arbitrum, Optimism, Polygon, Avalanche or BNB Chain, and free basics are enough or the user is willing to pay a small USDC fee for the full snapshot.
Requirements
Remote endpoint over streamable HTTP, or the npm package devx-token-snapshot run locally with Node.js via npx. No API key or account for the free tool. The paid snapshot needs a Base wallet key in X402_PRIVATE_KEY holding USDC, and network access to the hosted endpoint and public RPCs.
Before you install
The paid call spends 0.003 USDC per request from the wallet behind X402_PRIVATE_KEY, capped at 0.01 USDC by default; use a dedicated low-balance wallet. The remote MCP endpoint exposes only the free tool and the info tool. Risk flags are bytecode heuristics, not an audit, and a clean result does not mean a token is safe.

Installation

In SourceWeft

  1. Open DevX Token Snapshot 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%2Ftoken-snapshot/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-token-snapshot": {
      "type": "http",
      "url": "https://token-snapshot.nextill-pos.workers.dev/mcp"
    }
  }
}

README

DevX Token Snapshot

One call: what is this token, what is it worth, and is it risky? For any ERC-20 on Base, Ethereum, Arbitrum, Optimism, Polygon, Avalanche and BNB Chain you get the USD price, FDV, DEX liquidity, top pools, holder-concentration hints and bytecode risk flags. It is built for AI agents and apps that need a quick token check without an API key or their own indexer.

Everything comes from on-chain reads (DEX factory lookups, pool state, contract bytecode and storage) through public RPCs. No third-party market API. It is read-only, never asks for keys and never moves funds.

WhatCost
CLI / stdio MCP devx-token-snapshot (v2)Client for the hosted API below. Token basics are free; full / token_snapshot is the paid call, paid from your own wallet keyfree / 0.003 USDC
Remote MCP https://token-snapshot.nextill-pos.workers.dev/mcptoken_basics (free) + token_snapshot_infofree
HTTP API GET /v1/snapshotFull snapshot from the hosted endpoint: fallback RPCs, Multicall3, 20 s cache0.003 USDC via x402 on Base

Live: https://token-snapshot.nextill-pos.workers.dev · DEX list: /dexes.json · OpenAPI: /openapi.json

What a snapshot contains

  • token: name, symbol, decimals, total supply, block number
  • price_usd with its source pool, native coin USD price, fdv_usd
  • liquidity: total USD across pools found, the number of pools found, and the DEXes and quote assets checked (25 factory/chain pairs, see /dexes.json: Uniswap v2/v3, Aerodrome + Slipstream, Velodrome v2 + Slipstream, PancakeSwap v2/v3, SushiSwap, QuickSwap, Camelot, Trader Joe, Pangolin; quotes are wrapped native and the major stablecoins)
  • top_pools: dex, pool address, quote asset, depth in USD, price
  • holder_hints: share of supply in DEX pools, burned, held by the token contract and held by the owner, and whether the owner is a contract
  • contract / risk: owner, EIP-1967 proxy implementation and admin, and flags from a bytecode selector scan (mint, pause, blacklist, fee setters, max-tx limits, trading switch, upgradeable), plus a low/medium/high level

The risk flags are heuristics from bytecode and storage. They are not an audit, and a clean result does not mean a token is safe.

CLI

sh
npx devx-token-snapshot 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed                       # free: DEGEN basics on Base
# paid, 0.003 USDC per call: price, FDV, liquidity, pools, holder hints, risk flagsexport X402_PRIVATE_KEY=0x...   # a Base wallet holding a little USDC (use a dedicated low-balance wallet)npx devx-token-snapshot full 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed --pools 3npx devx-token-snapshot full 0x6982508145454Ce325dDbE47a25d4ec3d2311933 --chain ethereum  # PEPE on Ethereumnpx devx-token-snapshot paid-info

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, full prints the quote, pays nothing and exits with code 2. Since v2.0.0 the package is a thin client. It no longer computes snapshots locally.

MCP

Claude Desktop / Cursor (stdio):

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

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

Tools: token_basics (free), token_snapshot (0.003 USDC per call, pays only if X402_PRIVATE_KEY is set and never above 0.01 USDC, otherwise returns the quote), token_snapshot_info.

Paid hosted call (x402)

GET https://token-snapshot.nextill-pos.workers.dev/v1/snapshot?token=0x...&chain=base[&pools=5]POST https://token-snapshot.nextill-pos.workers.dev/v1/snapshot   {"token":"0x...","chain":"base","pools":5}

Unpaid requests get HTTP 402 with both an x402 v1 body (network: base, maxAmountRequired: 3000) and a v2 PAYMENT-REQUIRED header (eip155:8453). Pay with any x402 client, for example @x402/fetch, using your own wallet. Settlement goes through the Coinbase CDP facilitator and only happens after the snapshot has been produced. Input is checked before you are asked to pay. Free basics: GET https://token-snapshot.nextill-pos.workers.dev/api/basic?token=0x...&chain=base.

Layout

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

MIT. Made by DevX.

Source: README.md at commit 5c14ec8

Tools

2

token_basics

Free, read-only: ERC-20 name, symbol, decimals, total supply, proxy/owner presence and number of DEX pools found for a token on base, ethereum, arbitrum, optimism, polygon, avalanche, bsc. Live on-chain reads.

Parameterschaintokenrequired

token_snapshot_info

How to buy the full snapshot (USD price, liquidity, top DEX pools, holder-concentration hints, risk flags) via x402 for 0.003 USDC on Base. 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