1. Conduid
  2. Blockchain
  3. io.github.the402ai/mcp-server
MCP server · Blockchain

io.github.the402ai/mcp-server

by · github.com/the402ai/mcp-server

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

Unclaimed blockchain
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.the402ai/mcp-server

io.github.the402ai/mcp-server is an MCP server published by the402ai in the Blockchain category: aI agent service marketplace — browse, purchase, and manage services via x402/USDC.

The repository has 2 stars and 0 forks, with the last commit 7 days ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

Claude Code
claude mcp add io-github-the402ai-mcp-server -- npx -y @the402/mcp-server
npx
npx -y @the402/mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (3)

get_platform_infoPlatform health, status, referral program details

Parameters not published.

get_serviceGet full service details — pricing, input schema, provider reputation

Parameters not published.

search_catalogSearch services by keyword, category, type, price range

Parameters not published.

Ask AI

✦

Ask AI about io.github.the402ai/mcp-server

Powered by Claude · Grounded in docs

I know everything about io.github.the402ai/mcp-server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

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

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.

  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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.the402ai/mcp-server

How do I install io.github.the402ai/mcp-server?

Run claude mcp add io-github-the402ai-mcp-server -- npx -y @the402/mcp-server, then add the server to your MCP client's configuration.

Is io.github.the402ai/mcp-server safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.the402ai/mcp-server still maintained?

Yes — the last commit was 7 days ago. The repository has 2 stars and 0 forks.