AgentWallet MCP Server

Instructions

Implementation Reference

• src/index.ts:1274-1277 (handler)

  Handler function that executes the list_paywalls tool logic - makes an API call to /x402/paywalls endpoint with pagination parameters and returns the JSON response

  async ({ page, per_page }) => {
    const data = await api(`/x402/paywalls?page=${page}&per_page=${per_page}`);
    return jsonResponse(data);
  },

• src/index.ts:1270-1273 (schema)

  Input schema definition for list_paywalls tool using Zod - defines page number (default 1) and per_page results (default 50, max 100) parameters

  {
    page: z.number().int().default(1).describe('Page number'),
    per_page: z.number().int().default(50).describe('Results per page (max 100)'),
  },

• src/index.ts:1266-1278 (registration)

  Registration of list_paywalls tool with the MCP server - defines tool name, description, input schema, and handler function

  server.tool(
    'list_paywalls',
    'List all your x402 paywalls. Returns paywall IDs, names, pricing, ' +
      'access URLs, payment counts, and revenue totals.',
    {
      page: z.number().int().default(1).describe('Page number'),
      per_page: z.number().int().default(50).describe('Results per page (max 100)'),
    },
    async ({ page, per_page }) => {
      const data = await api(`/x402/paywalls?page=${page}&per_page=${per_page}`);
      return jsonResponse(data);
    },
  );