Log inSubmit server
X402 Bazaar MCP logo

X402 Bazaar MCP

by sukrutkrdg

Dynamically exposes Base token-safety and x402 Bazaar services as MCP tools with free, credit, or wallet-based payments.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install X402 Bazaar MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "sukrutkrdg-x402-bazaar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402-bazaar-mcp"
      ],
      "env": {
        "X402_CREDIT_TOKEN": "YOUR_VALUE_HERE",
        "AGENT_PRIVATE_KEY": "YOUR_VALUE_HERE",
        "X402_BAZAAR_CATALOG": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 2 tools correctly (9d ago).

Overview

sukrutkrdg/x402-bazaar-mcp MCP server connects MCP agents to the x402 Bazaar catalog and Base token-safety services. It loads the live catalog at startup, registering one MCP tool for each available service, including B20 checks, pre-trade gates, honeypot tests, wallet audits, sign guards, prices, and reports. Calls can use a free tier, prepaid credits, or USDC payments from a Base wallet. Reach for it when an agent needs token analysis or other catalogued x402 services without building individual API integrations.

Use cases

  • Check Base tokens before trading
  • Inspect B20 freeze and seizure controls
  • Audit wallet approvals before an interaction
  • Guard transaction signing with sign_guard
  • Query catalogued x402 services from an MCP agent

Key features

  • Dynamic tool registration from the live x402 catalog
  • B20 freeze, seizure, policy, mint, and rebase checks
  • Pre-trade, honeypot, and sellability analysis
  • Wallet, approval, and transaction sign-guard checks
  • Free tier, prepaid credits, and Base USDC wallet payments
  • Prices, gas, transaction decoding, and AI reports

Tools2

What X402 Bazaar MCP lets your agent do. Expand a tool for its parameters.

Verified live~291 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

8/9 checks healthy over the last 77d

What it can do

From the 2 tools this server returned when we ran it; 2 declare their own safety hints.

Handles credentials · 1Makes network requests · 2Read-only tools · 2
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age115 days
Maintainers1

Observed 2026-10-17 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · x402-bazaar-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1kPackage downloads in the last 30 days.
Last commit12d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed2Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How X402 Bazaar MCP works

What sukrutkrdg/x402-bazaar-mcp MCP server does

sukrutkrdg/x402-bazaar-mcp MCP server gives AI agents access to services in the x402 Bazaar through the Model Context Protocol. Its main use case is Base token safety before an agent trades, signs a transaction, or interacts with a token contract. The catalog includes checks for Base-native B20 tokens, including freeze and seizure authority, policy changes, mint headroom, and rebase history.

The available services also include pre-trade decision gates, honeypot and sellability checks, wallet and token-approval audits, transaction sign protection, prices, gas information, transaction decoding, deployer reputation, exit liquidity, and Claude-generated reports. The exact tool set is not fixed in the package documentation: it is discovered from the live catalog when the process starts.

Two tools are specifically recommended as starting points: pre_trade_gate for general token checks and b20_gate for Base-native B20 assets. Use sign_guard before an agent signs a transaction.

How it works

At startup, the process requests the service list from https://402.com.tr/api/catalog and creates one MCP tool for each catalog entry. When the agent invokes a tool, the server forwards the request to the corresponding service and returns its response.

Payment selection follows a defined order. If X402_CREDIT_TOKEN is present, the server sends it as an x-credit-token header and deducts the call cost from the prepaid balance. Otherwise, AGENT_PRIVATE_KEY enables local signing of an x402 USDC payment on Base when a service requires payment. With neither setting, services that offer a free tier provide one full call per day, followed by a preview; some AI and metered services are paid from the first call.

Wallet payments use the x402 sequence of receiving an HTTP 402 response, paying in USDC on Base, and retrying the request. The facilitator pays gas. Buying prepaid credits requires one initial x402 settlement and returns a ck_ token, allowing later calls without keeping a private key in the server configuration.

Setup and configuration

Node.js 20 or newer is required. Run the local stdio server with npx x402-bazaar-mcp. No environment variables are needed to try eligible free-tier services. For paid use, set either a prepaid token or a Base wallet private key. Credits take precedence when both are configured.

Supported variables are:

  • X402_CREDIT_TOKEN: prepaid ck_ credit token used for per-call deductions.
  • AGENT_PRIVATE_KEY: private key for a Base wallet holding USDC; used when no credit token is set.
  • X402_BAZAAR_CATALOG: optional replacement for the default catalog URL, intended for local development.

The package can be configured in Claude Desktop, Cursor, Cline, Windsurf, and VS Code by running it with npx. The hosted alternative is a Streamable HTTP endpoint at https://402.com.tr/mcp; the hosted service does not hold a wallet server-side. Coinbase AgentKit and other MCP-capable runtimes can also load the standard stdio process.

Tools and capabilities

The tool inventory is generated from the catalog rather than hard-coded in the README. This means newly added catalog services can appear without changing the local launch command. Relevant token-analysis categories include B20 administration and supply behavior, trading safety, wallet exposure, approvals, transaction signing, market data, and AI reports.

Payment is tied to individual service calls, while the free mode supports initial evaluation of eligible services.

Limitations and notes

The server depends on the live catalog and the remote x402 Bazaar endpoints, so the available tools may change over time. Not every catalog service has a free tier; AI and metered services can require payment immediately. Paid wallet mode requires a Base wallet with USDC and exposes the configured private key to the local process for signing. A prepaid credit token avoids per-call signing but still requires an initial purchase.

The package does not itself describe a fixed list of all tools or prices. Consult the server card and catalog for the current inventory and each service's freeTier status.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about X402 Bazaar MCP

sukrutkrdg/x402-bazaar-mcp is an MCP server that connects AI agents to the x402 Bazaar and Base token-safety services. It dynamically exposes tools for B20 checks, pre-trade gates, honeypot and sellability analysis, wallet and approval audits, sign guarding, prices, transaction data, and AI reports.

Install it by running `npx x402-bazaar-mcp` with Node.js 20 or newer. Add that command to the MCP configuration for Claude Desktop, Cursor, Cline, Windsurf, VS Code, or another MCP-capable runtime. Omitting payment variables starts the eligible free tier.

It supports prepaid credits, a Base wallet, or the free tier. `X402_CREDIT_TOKEN` is preferred and debits a prepaid balance through a request header. Without credits, `AGENT_PRIVATE_KEY` signs x402 USDC payments locally. With neither, eligible services allow one free call per day.

Yes, it works with Cursor through a standard stdio MCP configuration. Add an `x402-bazaar` entry that runs `npx -y x402-bazaar-mcp`, then optionally provide `X402_CREDIT_TOKEN` or `AGENT_PRIVATE_KEY` in the environment.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewX402 Bazaar MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/sukrutkrdg-x402-bazaar-mcp?style=directory)](https://allmcps.com/mcp/sukrutkrdg-x402-bazaar-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/sukrutkrdg-x402-bazaar-mcp"><img src="https://allmcps.com/api/badge/sukrutkrdg-x402-bazaar-mcp?style=directory" alt="X402 Bazaar MCP on AllMCPs" /></a>