get_paywall_payments
Retrieve verified payment history for a specific x402 paywall, including transaction hashes, payer addresses, amounts, and timestamps.
Instructions
Get payment history for a specific x402 paywall. Returns verified payments with TX hashes, payer addresses, amounts, and timestamps.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paywall_id | Yes | Paywall ID | |
| page | No | Page number | |
| per_page | No | Results per page (max 100) |
Implementation Reference
- src/index.ts:1344-1359 (handler)The complete implementation of the 'get_paywall_payments' MCP tool. It's registered with server.tool(), defines input parameters using Zod schema (paywall_id, page, per_page), and includes a handler function that makes an API call to retrieve payment history for a specific paywall, returning verified payments with transaction hashes, payer addresses, amounts, and timestamps.
// ─── Tool: get_paywall_payments ───────────────────────────────── server.tool( 'get_paywall_payments', 'Get payment history for a specific x402 paywall. ' + 'Returns verified payments with TX hashes, payer addresses, amounts, and timestamps.', { paywall_id: z.number().int().describe('Paywall ID'), page: z.number().int().default(1).describe('Page number'), per_page: z.number().int().default(20).describe('Results per page (max 100)'), }, async ({ paywall_id, page, per_page }) => { const data = await api(`/x402/paywalls/${paywall_id}/payments?page=${page}&per_page=${per_page}`); return jsonResponse(data); }, );