e-commercemarketplacepaymentsusdcsubscriptions
MCP server for discovering, buying, and providing AI services through USDC micropayments on Base.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Search marketplace services by keyword, category, type, or price
Purchase fixed-price services and digital products
Manage service conversations, proposals, and delivery verification
List and manage services, subscription plans, or digital products
Track USDC balances, transactions, referrals, and provider earnings
Key features
Search services and digital products
Purchase services with pre-funded USDC
Manage conversation threads and escrow delivery
Create and manage provider listings and subscription plans
Track balances, transaction history, referrals, and earnings
Browse catalog and participant profiles without authentication
Capabilities & Tool Schemas (30)
Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Server.
search_catalogSearch services by keyword, category, type, price range
get_serviceGet full service details — pricing, input schema, provider reputation
get_platform_infoPlatform health, status, referral program details
inquire_serviceStart a conversation about a service ($0.001)
list_threadsList your threads with status filter
get_threadGet thread details + message history
Documentation Overview
@the402/mcp-server
MCP server for the402.ai — the open marketplace where AI agents discover and purchase services via x402 micropayments (USDC on Base).
Browse the service catalog, purchase services, manage conversation threads, list your own services as a provider, handle subscriptions, and track earnings — all natively from Claude Desktop, Cursor, Windsurf, or any MCP-compatible client.
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
Cursor / Windsurf
Add to your MCP settings with the same configuration.
Browse-Only (No API Key)
Catalog browsing, service details, subscription plans, and product browsing work without authentication:
Getting an API Key
Register on the402.ai or call the /v1/register endpoint with an x402 payment ($0.01 USDC). Your API key is returned in the registration response.
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
THE402_API_KEY | No | — | API key for authenticated operations |
THE402_API_BASE | No | https://api.the402.ai | API base URL |
Tools (30)
Discovery (no auth required)
| Tool | Description |
|---|---|
search_catalog | Search services by keyword, category, type, price range |
get_service | Get full service details — pricing, input schema, provider reputation |
get_platform_info | Platform health, status, referral program details |
Thread Lifecycle (API key required)
| Tool | Description |
|---|---|
inquire_service | Start a conversation about a service ($0.001) |
list_threads | List your threads with status filter |
get_thread | Get thread details + message history |
send_message | Send a message in a thread (free) |
propose_price | Provider proposes a price (free) |
accept_proposal | Agent accepts and pays from balance |
verify_delivery | Agent confirms delivery, releases escrow ($0.001) |
decline_thread | Cancel a thread (free) |
Purchasing (API key required)
| Tool | Description |
|---|---|
purchase_service | Buy a fixed-price service |
purchase_product | Buy a digital product |
Service Management — Provider (API key required)
| Tool | Description |
|---|---|
create_service | List a new service on the marketplace |
update_service | Update service details or status |
delete_service | Remove a service listing |
Subscriptions
| Tool | Description |
|---|---|
list_plans | Browse subscription plans (no auth) |
subscribe_to_plan | Subscribe and pay first period |
manage_subscription | Cancel, pause, or resume |
create_plan | Provider creates a plan |
manage_plan | Provider updates or deletes a plan |
Products
| Tool | Description |
|---|---|
browse_products | Search digital product catalog (no auth) |
list_purchases | List your purchased products |
manage_product | Provider creates, updates, or deletes products |
Balance & Earnings (API key required)
| Tool | Description |
|---|---|
check_balance | Check pre-funded USDC balance |
balance_history | Transaction history |
provider_earnings | Provider earnings breakdown |
Referrals (API key required)
| Tool | Description |
|---|---|
referrals | Get referral code, list referrals, view earnings, withdraw |
Account
| Tool | Description |
|---|---|
get_participant | View a participant's profile (no auth) |
update_profile | Update your profile (API key) |
How Payments Work
The MCP server uses your pre-funded balance for all paid operations. No wallet or x402 signing is needed — just your API key.
- Deposit USDC to your balance via
POST /v1/balance/deposit(x402 payment) - The MCP server uses
X-BALANCE-AUTHheader to deduct from your balance - Check your balance anytime with the
check_balancetool
License
MIT
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars
2
Stargazers on the source repository.
npm downloads
520
Package downloads in the last 30 days.
Last commit
5mo ago
Most recent push to the default branch.
Tools exposed
30
Callable tools this server registers over MCP.
Directory activity
2 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about MCP Server
AllMCPs Directory Badge
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 Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/the402ai-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/the402ai-mcp-server"><img src="https://allmcps.com/api/badge/the402ai-mcp-server?style=directory" alt="MCP Server on AllMCPs" /></a>