# Token supply and market cap (x402)

> Token supply and market cap (x402) is a paid MCP server for crypto and web3. MCP server returning ERC-20/721 token supply, holders, price and market cap per x402 call. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://store.agentexchange.work
- **MCP Registry name:** work.agentexchange/token-supply
- **Categories:** [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-20

## About

This server answers on-chain token questions for AI clients: total supply, holder count, decimals, USD price and resulting market cap for ERC-20 and ERC-721 contracts. It is exposed as a streamable HTTP endpoint scoped to a single chain tool, so a client connects once and calls the token supply lookup directly.

Payment happens per call in USDC on Base using the x402 protocol, so there is no account, API key or subscription to set up. An agent that can sign a USDC payment can use it straight away, which suits pre-trade checks and automated research loops.

It is aimed at developers and agent builders who need quick token fundamentals inside a workflow rather than a dashboard for manual browsing.

## Features

- **Token supply lookup:** Returns total supply for ERC-20 and ERC-721 contracts.
- **Holder count and decimals:** Reports how many holders a token has along with its decimal precision.
- **USD price and market cap:** Combines a dollar price with supply to produce a market capitalisation figure.
- **Pay-per-call access:** Each request is settled in USDC on Base via x402 with no account or key.
- **Streamable HTTP transport:** Connects to MCP clients over a single streamable HTTP endpoint.

## Good for

- Pre-trade checks that confirm a token's supply and market cap before an agent acts
- Enriching research agents with on-chain token fundamentals
- Building trading or portfolio tools that need per-call market data without API keys
- Comparing token supply and holder counts across contracts in an automated workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http token-supply 'https://store.agentexchange.work/pretrade/mcp?tools=chain_token_supply'
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://store.agentexchange.work/pretrade/mcp?tools=chain_token_supply
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "token-supply": {
      "url": "https://store.agentexchange.work/pretrade/mcp?tools=chain_token_supply"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "token-supply": {
      "type": "http",
      "url": "https://store.agentexchange.work/pretrade/mcp?tools=chain_token_supply"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "token-supply": {
      "serverUrl": "https://store.agentexchange.work/pretrade/mcp?tools=chain_token_supply"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://store.agentexchange.work/pretrade/mcp?tools=chain_token_supply
```

Enter a Name (for example "Token supply and market cap (x402)"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "token-supply": {
      "type": "http",
      "url": "https://store.agentexchange.work/pretrade/mcp?tools=chain_token_supply"
    }
  }
}
```

## Tools

All 1 tool say they're read-only. From the server's own tool annotations; not verified by us.

- `chain_token_supply` (says read-only): $0.01 via x402: total supply, holder count, decimals, and live USD price / market cap for any ERC-20/721 token contract, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The supply read trading, valuation and risk agents make to size circulating supply, dilution and holder distribution before pricing or trading a token. Live from Blockscout; one paid call instead of running your own RPC

## FAQ

### How do I pay for calls?

Each call is paid in USDC on Base using the x402 protocol, with no account or API key required.

### Which token standards are supported?

The listing covers ERC-20 and ERC-721 contracts.

### What does the server return?

Total supply, holder count, decimals, USD price and market cap for a given token.

### Is Token supply and market cap (x402) free?

No. Token supply and market cap (x402) is a paid product.

### How do I add Token supply and market cap (x402) to Claude Code?

Run this command in your terminal: claude mcp add --transport http token-supply 'https://store.agentexchange.work/pretrade/mcp?tools=chain_token_supply'

### What are the best alternatives to Token supply and market cap (x402)?

The closest alternatives to Token supply and market cap (x402) are ERC-20 balance (x402), Crypto price, market cap, volume (x402), Prime-Agent x402 Intelligence, ERC-20 allowance check (x402) and Token security check (x402).

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 21 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [ERC-20 balance (x402)](https://ai-powered.com/mcp/erc-20-balance-x402): ERC-20 balance (x402) is a paid MCP server for finance and payments.
- [Crypto price, market cap, volume (x402)](https://ai-powered.com/mcp/crypto-price-market-cap-volume-x402): Crypto price, market cap, volume (x402) is a paid MCP server for finance and payments.
- [Prime-Agent x402 Intelligence](https://ai-powered.com/mcp/prime-agent-x402-intelligence): Prime-Agent x402 Intelligence is a paid MCP server for crypto and web3.
- [ERC-20 allowance check (x402)](https://ai-powered.com/mcp/erc-20-allowance-check-x402): ERC-20 allowance check (x402) is a paid MCP server for crypto and web3.
- [Token security check (x402)](https://ai-powered.com/mcp/token-security-check-x402): Token security check (x402) is a paid MCP server for security.
- [DEX token data (x402)](https://ai-powered.com/mcp/dex-token-data-x402): DEX token data (x402) is a paid MCP server for crypto and web3.
- [Wallet accumulating or distributing (x402)](https://ai-powered.com/mcp/wallet-accumulating-or-distributing-x402): Wallet accumulating or distributing (x402) is a paid MCP server for finance and payments.
- [LensExtract x402 On-Chain Data](https://ai-powered.com/mcp/lensextract-x402-on-chain-data): LensExtract x402 On-Chain Data is an open-source MCP server for crypto and web3.

---
Source: https://ai-powered.com/mcp/token-supply-and-market-cap-x402
