x402 MCP Server

Instructions

Implementation Reference

• src/index.ts:191-238 (handler)

  The implementation of the `x402_network_info` tool, which queries the status of various APIs in the x402 network and returns their health, pricing, and configuration status.

  // ─── Tool: x402_network_info (FREE) ─────────────────────────────────────────
  
  server.tool(
    "x402_network_info",
    `List all APIs in the x402 API Network with pricing, status, and capabilities.
  This tool is FREE — no payment required.
  
  The x402 API Network provides pay-per-use APIs accepting USDC micropayments on Base (L2 Ethereum).`,
    {},
    async () => {
      const walletConfigured = !!PRIVATE_KEY;
      const healthChecks = await Promise.allSettled(
        Object.entries(APIS).map(async ([key, api]) => {
          const health = await checkHealth(api.baseUrl);
          return { key, ...api, ...health };
        })
      );
  
      const results = healthChecks.map((r) => {
        if (r.status === "fulfilled") return r.value;
        return {
          key: "unknown",
          name: "Unknown",
          healthy: false,
          error: "Check failed",
        };
      });
  
      return textResult({
        network: "x402 API Network",
        blockchain: "Base (L2 Ethereum)",
        token: "USDC",
        wallet_configured: walletConfigured,
        payment_mode: walletConfigured
          ? "Automatic x402 payments enabled"
          : "Free test endpoints only — set X402_PRIVATE_KEY for paid access",
        apis: results.map((r: any) => ({
          id: r.key,
          name: r.name,
          status: r.healthy ? "online" : "offline",
          price: r.price,
          description: r.description,
          base_url: r.baseUrl,
          error: r.healthy ? undefined : r.error,
        })),
      });
    }
  );