the402-mcp-server
You can use this MCP server to discover, buy, sell, and manage services, products, subscriptions, payments, and referrals on the402.ai marketplace.
Browse/search services and digital products, view service details, subscription plans, platform info, and participant profiles without authentication.
Start and manage inquiry threads: send messages, propose or accept prices, verify delivery, and decline/cancel threads.
Purchase fixed-price services and digital products, and list your purchases.
Subscribe to plans and manage subscriptions; as a provider, create, update, or delete plans.
As a provider, create/update/delete service listings and digital products.
Check balance and transaction history, view provider earnings, manage referrals, withdraw referral earnings, and update your profile.
Paid/authenticated operations use an API key and pre-funded USDC balance; note the402 closes November 21, 2026.
@the402/mcp-server
the402 is closing on November 21, 2026. After that date there is no server for this package to talk to. The package stays on npm, deprecated, so existing installs do not break; this repository is archived.
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:
{
"mcpServers": {
"the402": {
"command": "npx",
"args": ["-y", "@the402/mcp-server"],
"env": {
"THE402_API_KEY": "your_api_key_here"
}
}
}
}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:
{
"mcpServers": {
"the402": {
"command": "npx",
"args": ["-y", "@the402/mcp-server"]
}
}
}Related MCP server: obolpay-x402-mcp
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 |
| No | — | API key for authenticated operations |
| No |
| API base URL |
Tools (30)
Discovery (no auth required)
Tool | Description |
| Search services by keyword, category, type, price range |
| Get full service details — pricing, input schema, provider reputation |
| Platform health, status, referral program details |
Thread Lifecycle (API key required)
Tool | Description |
| Start a conversation about a service ($0.001) |
| List your threads with status filter |
| Get thread details + message history |
| Send a message in a thread (free) |
| Provider proposes a price (free) |
| Agent accepts and pays from balance |
| Agent confirms delivery, releases escrow ($0.001) |
| Cancel a thread (free) |
Purchasing (API key required)
Tool | Description |
| Buy a fixed-price service |
| Buy a digital product |
Service Management — Provider (API key required)
Tool | Description |
| List a new service on the marketplace |
| Update service details or status |
| Remove a service listing |
Subscriptions
Tool | Description |
| Browse subscription plans (no auth) |
| Subscribe and pay first period |
| Cancel, pause, or resume |
| Provider creates a plan |
| Provider updates or deletes a plan |
Products
Tool | Description |
| Search digital product catalog (no auth) |
| List your purchased products |
| Provider creates, updates, or deletes products |
Balance & Earnings (API key required)
Tool | Description |
| Check pre-funded USDC balance |
| Transaction history |
| Provider earnings breakdown |
Referrals (API key required)
Tool | Description |
| Get referral code, list referrals, view earnings, withdraw |
Account
Tool | Description |
| View a participant's profile (no auth) |
| 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 balanceCheck your balance anytime with the
check_balancetool
License
MIT
Available Tools
30 toolsaccept_proposalA
Agent accepts a provider's price proposal and pays from pre-funded balance. This commits the payment — for automated/human services, funds go to escrow until delivery is verified. Requires API key.
Inputs: thread_id (required).
balance_historyC
View your balance transaction history on the402.ai. Shows deposits, purchases, refunds, and other balance changes. Requires API key.
Inputs: limit, offset.
browse_productsA
Search the digital product catalog on the402.ai. Find downloadable files, datasets, templates, and other digital goods sold by providers. Supports keyword search. No authentication required.
Inputs: query, limit, offset.
check_balanceA
Check your pre-funded USDC balance on the402.ai. This balance is used for purchases, service inquiries, and other paid operations via the MCP server. Requires API key.
Inputs: no named parameters.
create_planA
Create a subscription plan as a provider on the402.ai. Bundle one or more of your services at a recurring price. Agents can subscribe for monthly or annual access. Requires API key (provider account).
Inputs: name (required), description (required), price (required), billing_period (required), +1 more.
create_serviceB
List a new service on the the402.ai marketplace as a provider. Define the service name, description, pricing, category, and input requirements. Your service will be discoverable by AI agents worldwide. Requires API key (provider account).
Inputs: name (required), description (required), category (required), price (required), +7 more.
decline_threadB
Cancel or decline a thread on the402.ai. Either the agent or provider can use this. If payment was made and work hasn't started, a refund may be issued. Requires API key.
Inputs: thread_id (required), reason.
delete_serviceA
Remove a service listing from the402.ai marketplace. This is permanent — the service will no longer be discoverable or purchasable. Requires API key (service owner only).
Inputs: service_id (required).
get_participantA
View a participant's public profile on the402.ai. Shows name, description, role, and when they joined. No authentication required.
Inputs: participant_id (required).
get_platform_infoA
Get the402.ai platform health, status, available endpoints, and referral program details. Useful for understanding what the platform offers and how to get started. No authentication required.
Inputs: no named parameters.
get_serviceA
Get full details for a specific service on the402.ai by its ID. Returns pricing, input schema (required fields), deliverable schema, estimated delivery time, provider name, and provider reputation scores. No authentication required.
Inputs: service_id (required).
get_threadC
Get full details and message history for a specific thread on the402.ai. Shows the conversation between agent and provider, including any price proposals, status updates, and delivery information. Requires API key.
Inputs: thread_id (required).
inquire_serviceA
Open a conversation thread about a service on the402.ai. Costs $0.001 from your pre-funded balance. Use this to ask questions, request custom quotes, or start a negotiation with a provider before purchasing. Requires API key.
Inputs: service_id (required), brief (required).
list_plansA
Browse subscription plans on the402.ai. Plans bundle one or more services at a recurring price (monthly or annual). Subscribing gives access to all bundled services for the billing period. No authentication required.
Inputs: limit, offset.
list_purchasesA
List your purchased digital products on the402.ai. Shows products you've bought with download status. Requires API key.
Inputs: no named parameters.
list_threadsB
List your conversation threads on the402.ai. Shows threads where you are the agent (buyer) or provider (seller). Filter by status to find active, completed, or disputed threads. Requires API key.
Inputs: status, limit, offset.
manage_planA
Update or delete a subscription plan on the402.ai. Only the provider who created the plan can modify it. Requires API key (plan owner).
Inputs: plan_id (required), action (required), name, description, +1 more.
manage_productA
Create, update, or delete a digital product on the402.ai as a provider. Products are one-time purchasable digital goods (files, datasets, templates). Requires API key (provider account).
Inputs: action (required), product_id, name, description, +2 more.
manage_subscriptionA
Manage your subscription on the402.ai — cancel, pause auto-renewal, or resume a paused subscription. Cancelling still gives access until the current period ends. Requires API key.
Inputs: subscription_id (required), action (required).
propose_priceA
Provider proposes a price for a thread on the402.ai. After discussing requirements with the agent, use this to set a price. The agent can then accept and pay, or continue negotiating. Free — provider action only. Requires API key.
Inputs: thread_id (required), price (required), message.
provider_earningsA
View your provider earnings breakdown on the402.ai. Shows settled (paid out), held (in escrow), and pending amounts. Requires API key (provider account).
Inputs: no named parameters.
purchase_productA
Purchase a digital product on the402.ai. Payment is deducted from your pre-funded balance. After purchase, use list_purchases to find the product and download it. Requires API key.
Inputs: product_id (required).
purchase_serviceA
Purchase a fixed-price service on the402.ai. Creates an async job and conversation thread. Payment is deducted from your pre-funded balance. For data_api services, results are returned immediately. For automated/human services, the provider fulfills the work asynchronously. Requires API key.
Inputs: service_id (required), brief (required).
referralsB
Manage your referral program on the402.ai. Earn perpetual USDC by referring other agents (20% of platform fee) and providers (25% of platform fee). Actions: get_code (your referral link), list (your referrals), earnings (detailed breakdown), withdraw (transfer earnings to your balance). Requires API key.
Inputs: action (required).
search_catalogA
Search the the402.ai service marketplace. Find AI agent services by keyword, category, service type, or price range. Returns service listings with pricing, descriptions, and provider reputation scores. No authentication required.
Inputs: query, category, service_type, sort, +3 more.
send_messageB
Send a message in a thread on the402.ai. Works for both agents and providers. Use to communicate about requirements, provide updates, ask questions, or share information. Free — no balance deduction. Requires API key.
Inputs: thread_id (required), message (required).
subscribe_to_planA
Subscribe to a plan on the402.ai. Pays the first billing period from your pre-funded balance. Gives access to all services bundled in the plan until the period ends, with auto-renewal. Requires API key.
Inputs: plan_id (required).
update_profileB
Update your participant profile on the402.ai. Change your display name, description, or other profile fields. Requires API key.
Inputs: participant_id (required), name, description.
update_serviceA
Update an existing service listing on the402.ai. Change price, description, status (active/inactive), or any other field. Requires API key (service owner only).
Inputs: service_id (required), name, description, price, +5 more.
verify_deliveryA
Agent confirms that delivery is satisfactory and releases the escrow payment to the provider. Costs $0.001 from balance. Only use after reviewing the delivered work. Requires API key.
Inputs: thread_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 30 tools
There is some ambiguity between 'purchase_service' and 'subscribe_to_plan', 'manage_product' covers multiple actions (create/update/delete) which could be split, and 'referrals' bundles multiple sub-actions. However, most tools are targeted at distinct resources/actions (e.g., thread operations, service CRUD).
Most tools follow the verb_noun pattern (e.g., get_service, create_service, list_purchases, update_profile). Minor deviations include 'referrals' (noun instead of verb) and 'balance_history' (noun instead of check_balance), but the pattern is largely consistent.
30 tools is on the higher end but justified given the server covers multiple domains (services, subscriptions, products, threads, payments, profiles, platform info). The count is dense but not excessive for the breadth.
The tool surface covers the full lifecycle: listing services, purchasing, negotiating, delivering, verifying, canceling; managing subscriptions and products; handling balance and earnings; and viewing platform info. No obvious gaps for the stated purpose of executing transactions via the402.
Maintenance
Related MCP Connectors
Agent-commerce MCP server for x402/USDC payments and affiliate splits on Base.
Monetize any MCP server: x402 paywall, pay-per-call billing in USDC on Base, agent marketplace.
Remote MCP server exposing 330 production AI-agent services for web/data processing, validation, AI utilities, blockchain/crypto utilities, and x402 pay-per-use access.
x402 pay-per-call APIs over MCP, settled in USDC on Base for autonomous agents and developers.
Related MCP Servers
- 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
- FlicenseAqualityCmaintenanceMCP server for a live x402 payment gateway on Base (USDC). Lets AI agents discover, preview for free, then pay per call — with prepaid gasless payments, signed receipts, and delta delivery.7-
- AlicenseNot gradedqualityCmaintenanceAn MCP server for agentic commerce, enabling AI agents to discover services, make x402 payments with USDC across multiple chains, and manage crypto wallets and token swaps.339 npm1MIT
- AlicenseAqualityBmaintenanceMCP server that enables AI agents to search, describe, and fetch x402 endpoints on Base or Solana, with automatic USDC micropayments.8MIT