x402-bazaar-mcp
The x402-bazaar-mcp server gives AI agents pay-per-use access to on-chain data, DeFi tools, and AI utilities on the Base blockchain — no API keys or subscriptions, just USDC micro-payments.
Token & Contract Security
token_risk— Full safety score: honeypot detection, buy/sell taxes, ownership, holder concentration, LP lock %contract_abi— Check Sourcify verification status and retrieve a contract's ABIdecode_selector— Resolve 4-byte function selectors to human-readable signaturessanctions— Compliance screening for addresses
Prices & Market Data
token_price— Real-time USD price, 24h change, liquidity, and volume via DexScreenermulti_price— Prices for multiple tokens at oncetrending_tokens— Up to 15 currently trending Base tokensnew_tokens— Recently launched tokens on Basemarket_snapshot— Major crypto asset prices with intraday movesprice_alert— Webhook alert when a token crosses a price threshold (active 30 days)
Wallet & Address Intelligence
address_intel— EOA vs. contract, ETH/USDC balance, transaction count, and activity levelwallet_tokens— Portfolio of major Base tokens (ETH, WETH, USDC, DAI, cbETH, etc.) with live USD valuesholders— Holder data for a tokenbasename— Resolve Base Name Service names
Transaction & Gas Tools
gas_oracle— Live Base gas fee estimates (slow/normal/fast tiers in Gwei)tx_decode— Decode a transaction hash into a structured summary (from/to, value, status, gas, method, nonce)
Claude-Powered AI Utilities
ai_summarize— Summarize text into 3–5 bullet pointsai_extract— Extract named fields from unstructured text as JSONai_translate— Translate text into any target language
Miscellaneous
weather— Structured weather report for any cityquote— Rotating quote feed (cheapest endpoint; good for testing payment flow)secure_token— Generate cryptographically secure, URL-safe random tokens server-side
x402-bazaar-mcp
Hosted, no install: point any MCP client at https://402.com.tr/mcp —
Streamable HTTP, one tool per catalogued service, no wallet held server-side. Or
run it locally with npx as described below; both talk to the same catalog. The
current tool list is always
the server card; a number
written here would be wrong the next time a service is added.
The Base token-safety toolkit for AI agents. An MCP (Model Context Protocol) server that gives your agent the checks it needs before it touches a Base token — including a 30-tool B20 (Base-native token standard) suite covering freeze/seize powers, policy changes, mint headroom and rebase history — which also covers all 82 of Coinbase's tokenized equities, telling a real issuance apart from a token merely wearing an equity ticker by reading who administers the transfer policy on chain rather than by consulting a list of addresses, so a newly issued one is recognised the day it appears — pre-trade GO/HOLD/STOP gates, honeypot & sellability checks, wallet + approval audits, sign-guard, prices and AI reports. Every paid API in the x402 Bazaar catalog, exposed as a callable tool (Cursor, Cline, Windsurf, VS Code, Coinbase AgentKit, desktop assistants and custom agents).
Bind these first: pre_trade_gate (any Base token), near_pre_trade_gate
(NEAR tokens), b20_gate (Base-native B20 tokens), sign_guard (before signing
a tx).
Then act — swap at the best price, after the check:
base_swap— on Base, routed by 0x across Uniswap, Aerodrome, Balancer, Curve and more. Returns the route, minimum out, every fee, and a ready-to-sign transaction for your agent's own wallet. Buying an unknown token runs a sellability check first and refuses a honeypot.near_swap— across chains (NEAR, Base, Ethereum, Solana, Bitcoin…) through NEAR Intents. Returns a one-time deposit address; the output goes to your recipient or is refunded. Buying a NEAR token runsnear_token_safetyfirst. Track it withnear_swap_status.
Funds never pass through this server or ours.
No wallet needed to start. Run it with no key, no token and no config at all
and it uses the free tier — one free call/day on each service that offers
one. Roughly a third of the catalogue does not: AI and metered services are
always paid, and every entry in
the catalogue says which it is under
freeTier. When you outgrow
that, a prepaid credit token keeps it walletless: one purchase, then every call
is just an HTTP header. A wallet is only needed for the third mode, per-call
payment.
Each tool call is otherwise backed by an x402 micro-payment in USDC on Base — no API keys, no subscriptions, no sign-up. The agent pays only for what it uses, typically fractions of a cent per call.
Works with zero config. Run it with no wallet and no token and it uses the free tier (one free call/day on each service that offers one, then a preview) — so an agent can try most of the catalogue instantly, and sees a priced 402 on the AI and metered tools rather than a surprise. Unlock unlimited paid calls with either a prepaid credit token (one x402 purchase up front, then no wallet or signing per call) or a wallet key.
How it works
On startup the server fetches the live catalog from
https://402.com.tr/api/catalogand auto-registers one MCP tool per service.When an AI agent calls a tool the server picks a payment mode (below), hits the endpoint, and returns the response.
In wallet mode the x402 flow is transparent:
HTTP 402 → pay USDC on Base → retry → return response, gasless for the payer (the facilitator pays gas).
Three payment modes (precedence order)
Mode | Set | What happens | Wallet? Signing? |
Credits ⭐ |
| Sent as | No / No |
Wallet |
| Signs an x402 USDC payment locally per call | Yes / Yes |
Free | (nothing) | Free tier: 1 full call/day/service, then a preview | No / No |
Credits are the easiest paid mode day-to-day: buying the pack takes ONE x402
settlement (call the buy_credits tool in wallet mode, or pay
https://402.com.tr/api/x402/buy-credits?tier=0.25|1|5|20 from any x402 client),
which returns a ck_… token. Set it as X402_CREDIT_TOKEN and every later call
just draws down the balance — no private key ever touches this config again.
Tiers: $0.25 starter, $1, $5 (+10%), $20 (+20%).
Paying from NEAR? The same credit token can be bought with USDC, USDT or NEAR on
NEAR (or any asset NEAR Intents routes) — in the browser at
402.com.tr/credits, or headlessly with
POST https://402.com.tr/api/credits/near/quote. NEAR Intents swaps it to USDC on Base;
no Base wallet needed.
Related MCP server: x402-mcp
Requirements
Node.js ≥ 20
(optional, for paid calls) a prepaid credit token or a Base wallet private key whose address holds USDC on Base mainnet
Installation & running
npm install
# Zero-config — free tier on every service that offers one:
npx x402-bazaar-mcp
# Paid via prepaid credits (recommended — no wallet, no signing):
X402_CREDIT_TOKEN=ck_your_token npx x402-bazaar-mcp
# Paid via wallet:
AGENT_PRIVATE_KEY=0xYOUR_PRIVATE_KEY npx x402-bazaar-mcpIn wallet mode the key only ever signs for requests to https://402.com.tr, paying the
Bazaar's own address in USDC on Base, at or under X402_MAX_PRICE_USD. These are fixed in
the package (or set by those env vars) — never taken from the catalog or from a 402 — so a
catalog entry or a 402 that points anywhere else is called unpaid.
Environment variables
Variable | Required | Default | Description |
| no | — | Prepaid credit token ( |
| no | — | Hex private key for a Base wallet holding USDC. |
| no |
| Wallet mode: the most a single call may cost. A 402 asking for more is not signed. Raise it on purpose to buy larger credit packs from a wallet. |
| no |
| Wallet mode: the only origin the wallet pays, and the only address it pays to. |
| no |
| Override the catalog URL (useful for local dev). |
With none of the above set, the server runs on the free tier.
Desktop MCP clients
Most desktop assistants and IDEs read an mcpServers block from their MCP
config file (see your client's docs for where it lives). Add:
{
"mcpServers": {
"x402-bazaar": {
"command": "npx",
"args": ["-y", "x402-bazaar-mcp"],
"env": {
"X402_CREDIT_TOKEN": "ck_your_token"
}
}
}
}Omit the env block entirely to run on the free tier (great for a first
try), or use "AGENT_PRIVATE_KEY": "0x…" instead of the credit token to pay
from a wallet.
Restart the client after saving; the Bazaar tools appear in its tool list.
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:
{
"mcpServers": {
"x402-bazaar": {
"command": "npx",
"args": ["-y", "x402-bazaar-mcp"],
"env": { "X402_CREDIT_TOKEN": "ck_your_token" }
}
}
}Cline (VS Code)
In the Cline panel → MCP Servers → Configure (cline_mcp_settings.json):
{
"mcpServers": {
"x402-bazaar": {
"command": "npx",
"args": ["-y", "x402-bazaar-mcp"],
"env": { "X402_CREDIT_TOKEN": "ck_your_token" },
"disabled": false,
"autoApprove": []
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"x402-bazaar": {
"command": "npx",
"args": ["-y", "x402-bazaar-mcp"],
"env": { "X402_CREDIT_TOKEN": "ck_your_token" }
}
}
}VS Code (GitHub Copilot / MCP)
Add to .vscode/mcp.json in your workspace (or run MCP: Add Server):
{
"servers": {
"x402-bazaar": {
"command": "npx",
"args": ["-y", "x402-bazaar-mcp"],
"env": { "X402_CREDIT_TOKEN": "ck_your_token" }
}
}
}Every client above works the same way: omit env to run on the free tier,
or swap the credit token for "AGENT_PRIVATE_KEY": "0x…" to pay from a wallet.
Use with Coinbase AgentKit, Agentic Wallet & CLI agents
Because this is a standard MCP stdio server, any MCP-capable agent runtime can load and pay for the Bazaar's tools — including Coinbase's own agent stack, with no bespoke integration:
Coinbase Agentic Wallet (npx awal)
Coinbase Agentic Wallets ship
native x402 support and an MCP interface. Point the wallet's MCP config at
npx x402-bazaar-mcp, and the agent can call — and pay for — any Bazaar service
straight from its MPC-secured wallet, gasless on Base. The x402 payment handshake
is handled for you: HTTP 402 → pay USDC on Base → retry → response.
Coinbase AgentKit
Two ways in:
As MCP tools — load this server into your AgentKit agent's MCP config (
command: "npx",args: ["-y", "x402-bazaar-mcp"], andX402_CREDIT_TOKENorAGENT_PRIVATE_KEYinenv). The agent gains every Bazaar tool — B20 freeze/seize checks, pre-trade gates, honeypot/sellability, deployer reputation, exit liquidity, live DEX prices, gas, tx decode, AI reports — as pay-per-call actions, no action provider to write.Via AgentKit's native x402 support — AgentKit's wallet can settle x402 payments directly, so an agent can
GET https://402.com.tr/api/x402/<service>and pay the returned 402 from its own wallet. The 402 body includes a machine-readablealternativesblock (starter credits first) so the agent can pick the cheapest on-ramp programmatically.
Either way the agent pays only for the calls it makes, in USDC on Base, gasless.
Command-line agents
CLI agents that manage MCP servers with an mcp add command take the same
server:
# Free tier (zero config):
<agent-cli> mcp add x402-bazaar -- npx -y x402-bazaar-mcp
# Or paid via prepaid credits:
<agent-cli> mcp add x402-bazaar -e X402_CREDIT_TOKEN=ck_your_token -- npx -y x402-bazaar-mcpThen ask the agent to check a token, price a portfolio, or screen an address — it calls the right Bazaar tool and settles the micro-payment automatically.
Why agents use this
Agents need fresh on-chain data and AI utilities but don't want to manage RPC endpoints, scrapers, security heuristics, or per-provider API keys. One MCP server plus a credit token (or a funded wallet) gives them everything — contract safety checks, live DEX prices, gas estimates, transaction decoding, and AI-powered reports — all pay-per-use, with no subscriptions or sign-up required.
What your agent can do (tools)
Tools are loaded live from the catalog, so the list stays current. At the time of writing it includes:
Tool | Price | What it does |
| $0.10 | The one call before a trade — risk + sellability + route + deployer → GO/HOLD/STOP |
| $0.03 | Token safety score (honeypot, taxes, ownership, holders) for any Base token |
| $0.08 | Can you actually SELL it? Honeypot/tax/lp simulation verdict |
| $0.12 | AI-written full due-diligence report on a token |
| $0.02 | Screen an address against the OFAC sanctions list |
| $0.02 | Top holders, concentration (whale risk) & LP lock for a token |
| $0.02 | DEX price + liquidity for a Base token |
| $0.02 | Prices for up to 10 Base tokens in one call |
| $0.02 | EOA/contract, ETH+USDC balance, activity for any address |
| $0.02 | Portfolio of major Base tokens + USD value |
| $0.01 | Live Base gas estimates (slow/normal/fast) |
| $0.02 | Structural decode of a Base transaction |
| $0.02 | Is a contract verified? Get its ABI (Sourcify) |
| $0.01 | Resolve Basenames ↔ addresses on Base |
| $0.01 | Trending & freshly listed Base tokens |
| $0.05 | Register an alert when a token crosses a price (webhook or poll) |
| $0.25–$20 | Buy a prepaid credit pack (tier param) — unlocks walletless calls |
Prices shown as of this release — the authoritative price is always in the live
catalog and in each 402 challenge. The table above is a sample: the tool list is
loaded live from the catalog at startup, so the server always exposes
everything the marketplace currently sells — including the
B20 safety suite, the web and business checks (url_extract, email_verify,
domain_check) and anything added since this README was written.
Example
Once installed, just ask your agent naturally — it picks the right tool and pays per call:
"Is
0x…a safe token to buy on Base? Check the risk and current price."
The agent calls token_risk and token_price, each settling a tiny USDC payment
from your wallet, and answers with the on-chain data.
"Is this NVDA token on Base the real Coinbase one?"
b20_safety answers from the chain rather than from a list: it reads who
administers the token's transfer policy and reports whether that is the operator
behind Coinbase's confirmed issuances. A lookalike can copy the ticker, the name
and even a 0xb200… vanity address; it cannot borrow the policy administrator.
The same answer carries the issuer's powers — holder-eligibility gating, gated
mint, and the rebase multiplier that redenominates every balance at once — as
facts about a regulated instrument, not as a risk score to be alarmed by.
Sample outputs
token_risk — low-risk token
{
"address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"isContract": true,
"token": {
"name": "USD Coin",
"symbol": "USDC",
"decimals": 6,
"totalSupply": "4800000000000000"
},
"ownership": {
"owner": "0x0000000000000000000000000000000000000000",
"renounced": true
},
"upgradeableProxy": false,
"security": {
"isHoneypot": false,
"buyTaxPct": 0,
"sellTaxPct": 0,
"isOpenSource": true,
"isMintable": false,
"transferPausable": false,
"canTakeBackOwnership": false,
"hiddenOwner": false,
"holderCount": 182430,
"topHolderPct": 12.47,
"top10HolderPct": 41.22,
"lockedLpPct": 100,
"creatorPct": 0,
"isInDex": true,
"isAntiWhale": false,
"antiWhaleModifiable": false,
"tradingCooldown": false,
"slippageModifiable": false,
"isTrueToken": true,
"isAirdropScam": false,
"creatorAddress": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
"creatorBalance": "0"
},
"riskScore": 0,
"riskLevel": "low",
"flags": [],
"sources": ["base-rpc", "goplus"],
"coverage": "RPC base + GoPlus security (honeypot, taxes, holders, holder concentration, LP lock, creator holdings, source, ownership controls).",
"checkedAt": "2026-06-23T09:14:02.381Z"
}token_price — DEX price and liquidity
{
"address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"priceUsd": "0.9998",
"priceChange24h": -0.03,
"liquidityUsd": 4721850.44,
"volume24h": 18340210.77,
"dexId": "uniswap",
"pairAddress": "0x88A43bbDF9D098eEC7bCEda4e2494615dfD9bB9C",
"baseToken": {
"name": "USD Coin",
"symbol": "USDC"
},
"checkedAt": "2026-06-23T09:14:03.105Z"
}Discovering available services
Human-readable catalog & docs: https://402.com.tr/agents
Machine-readable catalog (used by this server): https://402.com.tr/api/catalog
x402 well-known: https://402.com.tr/.well-known/x402
Security note
Prepaid credits (recommended) keep wallets out of your agent config — buying
the pack takes one x402 settlement, but after that the ck_… token is all the
agent holds: a bearer capability worth only its remaining balance, so a leaked
token can lose at most what's left on it, never a wallet. Buy a small pack and
rotate it if needed.
If you use wallet mode instead, your private key is only used locally inside this process to sign payment authorizations. It is never sent to the Bazaar server or any third party. Use a dedicated spending wallet (not your main wallet) and keep only a small USDC balance on it.
License
MIT
Available Tools
17 toolsaddress_intelA
EOA vs contract, ETH + USDC balance, transaction count and activity level — straight from Base RPC. Useful for counterparty and wallet checks.
Inputs: address (required).
ai_extractA
Pull named fields out of any text as clean JSON (e.g. name, email, company, date). Powered by Claude structured outputs.
Inputs: text (required), fields.
ai_summarizeA
Paste text and get a 3-5 bullet summary from Claude. Pay-per-call — no API key or subscription needed on your side.
Inputs: text (required).
ai_translateA
Translate text into a target language with Claude. One micro-payment per translation.
Inputs: text (required), to.
contract_abiA
Checks Sourcify for a Base contract's verification status and returns its ABI as function/event name lists + item count (full or partial match). No API key required.
Inputs: address (required).
decode_selectorB
Resolves a 4-byte function selector (e.g. 0x70a08231) to candidate human-readable signatures via 4byte.directory. Accepts a bare selector or full calldata.
Inputs: selector (required).
gas_oracleA
Returns current Base gas fees (baseFee, maxPriorityFee) and three tiered suggestions (slow, normal, fast) in Gwei, derived live from the Base RPC. Built for agents that time or cost-estimate transactions.
Inputs: no named parameters.
market_snapshotA
Returns a snapshot of major crypto assets with a pseudo-random intraday move. One USDC micro-payment per call.
Inputs: no named parameters.
price_alertA
Pay once to register a price-threshold alert on any Base token. Supply target price, direction (above/below), and an https webhook URL. A polling cron checks DexScreener and POSTs your webhook the moment it crosses. Expires after 30 days.
Inputs: token (required), threshold (required), direction (required), webhook (required).
quoteA
A rotating quote feed. The cheapest possible paid endpoint — perfect for testing your wiring.
Inputs: no named parameters.
secure_tokenC
Generate N url-safe random tokens server-side. Demonstrates a paid utility endpoint with a query parameter.
Inputs: count.
token_priceA
Pass a Base token contract address and get the current USD price, 24h change, liquidity, and volume from DexScreener (highest-liquidity pair auto-selected). No API key required.
Inputs: address (required).
token_riskA
Pass a token contract address and get a risk score + flags (ERC-20 conformance, ownership renounce, upgradeable proxy) computed live from Base. Built for trading bots and agents that vet tokens before buying.
Inputs: address (required).
trending_tokensA
Fetches the DexScreener boosts feed filtered to Base — up to 15 trending tokens with address, description, boost amount, and link. Great for discovery bots.
Inputs: no named parameters.
tx_decodeA
Provide a Base transaction hash and get a structured summary: from/to, ETH value, status, gas used, block, method selector, and nonce — straight from Base RPC.
Inputs: hash (required).
wallet_tokensA
Returns native ETH plus WETH, USDC, USDbC, DAI, cbETH balances for any Base address, enriched with live USD values via DexScreener. Only non-zero holdings are returned.
Inputs: address (required).
weatherB
Pass a city and get a structured weather report. Mirrors the canonical x402 /weather example so you can compare wire formats.
Inputs: city (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Most tools have distinct purposes; minor overlap exists between address_intel and wallet_tokens (both provide balances) and between token_price and token_risk (both analyze tokens), but descriptions clarify differences.
All names use snake_case, but the naming pattern is inconsistent: some start with nouns (address_intel, token_price) while others start with categories (ai_extract, ai_summarize) or are generic (weather, quote). No verb_noun pattern is followed.
17 tools is slightly above average but justifiable for a multi-purpose server. Each tool provides a distinct utility, though the overall set feels a bit scattered.
The tool set covers a broad collection of independent utilities (blockchain, AI, general). Within blockchain read operations, it's fairly complete, but missing features like historical data or write capabilities. For a 'bazaar' concept, coverage is adequate.
Maintenance
Related MCP Connectors
Pay-per-use MCP tools for AI agents. USDC on Base via x402. No API keys.
x402 pay-per-call APIs over MCP, settled in USDC on Base for autonomous agents and developers.
MCP server for X420's pay-per-call agent services (x402, USDC on Base, paid from your own wallet).
Pay-per-call x402 MCP: 22 agent APIs on Base USDC. Crypto, onchain reads, repo safety. From $0.001
Related MCP Servers
- AlicenseAqualityDmaintenanceBridges Claude with a live FreeCAD instance to provide deep access to runtime state, document structure, and shape topology. It enables AI-assisted CAD work, sketch diagnostics, and development debugging through direct interaction with FreeCAD's internal data and viewport.937GNU Lesser General Public v2.1 or later
- AlicenseCqualityDmaintenanceMCP server bringing 100+ x402-paid APIs to AI agents (Claude, Cursor, MCP-aware clients). Auto-discovers tools from CDP Bazaar; handles USDC micropayments on Base.10083 npm1MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that provides AI agents with pay-per-call access to a suite of tools (honeypot check, token market, DeFi yields, etc.) via USDC on Base using the x402 protocol.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server exposing 10 curated tools for AI agents, providing crypto trading signals, on-chain analysis, and web utilities via pay-per-call x402 endpoints on the Base network.MIT