English Français العربية

io.github.the402ai/mcp-server

السجل الرسمي مؤرشف التجارة الإلكترونية

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @the402/mcp-server
Claude Code 
claude mcp add io-github-the402ai-mcp-server -- npx -y @the402/mcp-server@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-the402ai-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@the402/mcp-server@1.0.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @the402/mcp-server
  2. Quick Start
  3. Getting an API Key
  4. Configuration
  5. Tools (30)
  6. How Payments Work
  7. License

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

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_KEYNo—API 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

الأسئلة الشائعة

ما هو io.github.the402ai/mcp-server؟

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

كيف أثبّت io.github.the402ai/mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add io-github-the402ai-mcp-server -- npx -y @the402/mcp-server@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.the402ai/mcp-server إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.the402ai/mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.the402ai/mcp-server؟

ينشره the402ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.