Back to Browse

The402ai MCP Server

Developer ToolsLow Risk9.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

AI agent service marketplace — browse, purchase, and manage services via x402/USDC

About

AI agent service marketplace — browse, purchase, and manage services via x402/USDC

Security Report

9.0
Low Risk9.0Low Risk

Valid MCP server (10 strong, 11 medium validity signals). No known CVEs in dependencies. ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry.

12 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-the402ai-mcp-server": {
      "args": [
        "-y",
        "@the402/mcp-server"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

@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:

{
	"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"]
		}
	}
}

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

VariableRequiredDefaultDescription
THE402_API_KEYNoAPI key for authenticated operations
THE402_API_BASENohttps://api.the402.aiAPI base URL

Tools (30)

Discovery (no auth required)

ToolDescription
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

Thread Lifecycle (API key required)

ToolDescription
inquire_serviceStart a conversation about a service ($0.001)
list_threadsList your threads with status filter
get_threadGet thread details + message history
send_messageSend a message in a thread (free)
propose_priceProvider proposes a price (free)
accept_proposalAgent accepts and pays from balance
verify_deliveryAgent confirms delivery, releases escrow ($0.001)
decline_threadCancel a thread (free)

Purchasing (API key required)

ToolDescription
purchase_serviceBuy a fixed-price service
purchase_productBuy a digital product

Service Management — Provider (API key required)

ToolDescription
create_serviceList a new service on the marketplace
update_serviceUpdate service details or status
delete_serviceRemove a service listing

Subscriptions

ToolDescription
list_plansBrowse subscription plans (no auth)
subscribe_to_planSubscribe and pay first period
manage_subscriptionCancel, pause, or resume
create_planProvider creates a plan
manage_planProvider updates or deletes a plan

Products

ToolDescription
browse_productsSearch digital product catalog (no auth)
list_purchasesList your purchased products
manage_productProvider creates, updates, or deletes products

Balance & Earnings (API key required)

ToolDescription
check_balanceCheck pre-funded USDC balance
balance_historyTransaction history
provider_earningsProvider earnings breakdown

Referrals (API key required)

ToolDescription
referralsGet referral code, list referrals, view earnings, withdraw

Account

ToolDescription
get_participantView a participant's profile (no auth)
update_profileUpdate 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.

  1. Deposit USDC to your balance via POST /v1/balance/deposit (x402 payment)
  2. The MCP server uses X-BALANCE-AUTH header to deduct from your balance
  3. Check your balance anytime with the check_balance tool

License

MIT

Reviews

No reviews yet

Be the first to review this server!

The402ai MCP Server - AI agent service marketplace — browse, purchase, and manage | MCP Marketplace