sukrutkrdg/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 runs near_token_safety first.
Track it with near_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
1. On startup the server fetches the live catalog from
https://402.com.tr/api/catalog and auto-registers one MCP tool per
service.
2. When an AI agent calls a tool the server picks a payment mode (below), hits
the endpoint, and returns the response.
3. 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** ⭐ | X402_CREDIT_TOKEN | Sent as x-credit-token; each call debits your prepaid balance | No / No |
| **Wallet** | AGENT_PRIVATE_KEY | Signs an x402 USDC payment locally per call | Yes / Yes |
| **Free** | *(nothing)* | Free tier: 1 full call/day/service, then a preview | No / No |