agentwallet-mcp 1.3.0 → 1.5.0

package/README.md

@@ -4,11 +4,15 @@ Permissionless EVM wallet infrastructure for AI agents. Create wallets, sign tra
 
 **No KYC. No KYT. No transaction monitoring. No one can block your wallet.**
 
+<p align="center">
+  <img src="assets/demo.svg" alt="AgentWallet demo — AI agent pays x402 invoice automatically" width="800">
+</p>
+
 ## Features
 
-- **21 MCP tools** — create wallets, send transactions, approve tokens, wrap ETH, pay x402 invoices, and more
+- **28 MCP tools** — create wallets, send transactions, approve tokens, wrap ETH, pay and accept x402 payments, and more
 - **Any EVM chain** — Ethereum, Base, Polygon, BSC, Arbitrum, Optimism, Avalanche, Zora, PulseChain, and any other EVM-compatible chain
-- **x402 payments** — automatically pay for x402-enabled APIs and resources on any supported chain
+- **x402 payments** — pay for x402-enabled APIs automatically, or accept x402 payments on your own endpoints
 - **Secure** — Private keys encrypted at rest, decrypted only during signing, zeroed from memory immediately after
 - **Permissionless** — No identity verification, no compliance gatekeeping. Create a wallet and transact immediately.
 
@@ -16,6 +20,8 @@ Permissionless EVM wallet infrastructure for AI agents. Create wallets, sign tra
 
 - **$0.0069 per transaction** (31% less expensive than Coinbase CDP)
 - **6,000 free transactions/month**
+- **$0.0005 per x402 verification** (50% less expensive than Coinbase)
+- **1,000 free x402 verifications/month**
 - No monthly fee, no tiers — just pay as you go
 
 ## Quick Start
@@ -91,6 +97,13 @@ Add to your settings:
 | `wrap_eth` | Wrap native tokens to WETH/WAVAX/etc. |
 | `unwrap_eth` | Unwrap WETH back to native tokens |
 | `pay_x402` | Pay x402 invoices automatically (fetch, pay, retry) |
+| `create_paywall` | Create an x402 paywall to charge for a resource |
+| `list_paywalls` | List all your x402 paywalls |
+| `get_paywall` | Get paywall details by ID |
+| `update_paywall` | Update paywall pricing, resource, or status |
+| `delete_paywall` | Delete a paywall |
+| `get_paywall_payments` | View payment history for a paywall |
+| `get_x402_revenue` | Aggregate revenue stats across all paywalls |
 | `get_usage` | Check your monthly usage and billing |
 | `get_chains` | List all supported chains |
 | `pause_wallet` | Emergency pause a wallet |
@@ -145,12 +158,35 @@ pay_x402(
 
 Supports ERC-20 tokens (USDC, USDT) and native tokens on any chain. Compatible with x402 V1 and V2 (CAIP-2 chain identifiers).
 
+## x402 Acceptance
+
+AgentWallet also lets you **accept** x402 payments. Create a paywall, point it at any resource, and get a public URL that charges agents automatically:
+
+```
+create_paywall(
+  wallet_id=1,
+  name="Premium API",
+  amount="0.01",
+  token_name="USDC",
+  token_address="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  chain_id=8453,
+  resource_url="https://your-api.com/data"
+)
+```
+
+When an agent hits the paywall URL:
+1. Gets back HTTP 402 with payment requirements
+2. Pays on-chain using `pay_x402` (or any x402-compatible client)
+3. Retries with proof of payment
+4. Receives the protected content
+
+On-chain verification ensures every payment is real. Replay protection prevents double-spending. Revenue tracking shows you who paid, how much, and when.
+
 ## Security
 
 - Private keys are generated server-side and encrypted at rest
 - Keys are decrypted only during transaction signing and zeroed from memory immediately after
 - EIP-1559 transactions only with gas safety caps
-- Emergency pause: freeze any wallet or all wallets instantly
 - Bug bounty program: $50–$500 for responsible disclosure ([details](https://hifriendbot.com/wallet))
 
 ## Links

package/build/index.js

@@ -111,7 +111,7 @@ function resolveChainId(network) {
 // ─── Server ──────────────────────────────────────────────────────
 const server = new McpServer({
     name: 'agentwallet',
-    version: '1.3.0',
+    version: '1.5.0',
 });
 // ─── Tool: create_wallet ─────────────────────────────────────────
 server.tool('create_wallet', 'Create a new EVM wallet. Returns the wallet ID and address. ' +
@@ -663,6 +663,114 @@ server.tool('delete_wallet', 'Delete (soft-delete) a wallet. The wallet will no
     const data = await api(`/wallets/${wallet_id}`, 'DELETE');
     return jsonResponse(data);
 });
+// ─── Tool: create_paywall ────────────────────────────────────────
+server.tool('create_paywall', 'Create an x402 paywall that charges agents/clients for accessing a resource. ' +
+    'Returns a public access URL that returns HTTP 402 until paid. ' +
+    'Agents pay on-chain, then retry with proof to get the content.', {
+    wallet_id: z.number().int().describe('Wallet ID to receive payments'),
+    name: z.string().describe('Human-readable paywall name (e.g. "Premium API Access")'),
+    description: z.string().default('').describe('Description shown in the 402 response'),
+    amount: z.string().describe('Price in human-readable format (e.g. "0.01" for 0.01 USDC)'),
+    token_type: z.enum(['erc20', 'native']).default('erc20').describe('"erc20" for stablecoin payments, "native" for ETH/POL/etc.'),
+    token_address: z.string().default('').describe('ERC-20 token contract address (required if token_type is "erc20"). Use get_chains to find stablecoin addresses.'),
+    token_decimals: z.number().int().default(6).describe('Token decimals (6 for USDC, 18 for ETH/most tokens)'),
+    token_name: z.string().default('USDC').describe('Token display name (e.g. "USDC", "ETH")'),
+    chain_id: z.number().int().default(8453).describe('Chain ID for payments (8453=Base, 1=Ethereum, etc.)'),
+    resource_url: z.string().url().describe('URL of the protected resource to serve after payment verification'),
+    resource_mime: z.string().default('application/json').describe('MIME type of the resource (e.g. "application/json", "text/plain")'),
+}, async ({ wallet_id, name, description, amount, token_type, token_address, token_decimals, token_name, chain_id, resource_url, resource_mime }) => {
+    // Convert human-readable amount to raw token units
+    const rawAmount = parseUnits(amount, token_decimals);
+    const data = await api('/x402/paywalls', 'POST', {
+        wallet_id,
+        name,
+        description,
+        amount: rawAmount,
+        token_type,
+        token_address,
+        token_decimals,
+        token_name,
+        chain_id,
+        resource_url,
+        resource_mime,
+    });
+    return jsonResponse({
+        ...data,
+        price: `${amount} ${token_name}`,
+        chain_id,
+    });
+});
+// ─── Tool: list_paywalls ────────────────────────────────────────
+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);
+});
+// ─── Tool: get_paywall ──────────────────────────────────────────
+server.tool('get_paywall', 'Get details for a specific x402 paywall by ID. ' +
+    'Returns pricing, access URL, payment stats, and configuration.', {
+    paywall_id: z.number().int().describe('Paywall ID'),
+}, async ({ paywall_id }) => {
+    const data = await api(`/x402/paywalls/${paywall_id}`);
+    return jsonResponse(data);
+});
+// ─── Tool: update_paywall ───────────────────────────────────────
+server.tool('update_paywall', 'Update an x402 paywall configuration. ' +
+    'Can change price, resource URL, active status, or any other field.', {
+    paywall_id: z.number().int().describe('Paywall ID to update'),
+    name: z.string().optional().describe('New paywall name'),
+    description: z.string().optional().describe('New description'),
+    amount: z.string().optional().describe('New price in human-readable format (e.g. "0.05")'),
+    token_decimals: z.number().int().optional().describe('Token decimals (needed if changing amount)'),
+    resource_url: z.string().url().optional().describe('New resource URL'),
+    resource_mime: z.string().optional().describe('New MIME type'),
+    is_active: z.boolean().optional().describe('Enable (true) or disable (false) the paywall'),
+}, async ({ paywall_id, name, description, amount, token_decimals, resource_url, resource_mime, is_active }) => {
+    const body = {};
+    if (name !== undefined)
+        body.name = name;
+    if (description !== undefined)
+        body.description = description;
+    if (resource_url !== undefined)
+        body.resource_url = resource_url;
+    if (resource_mime !== undefined)
+        body.resource_mime = resource_mime;
+    if (is_active !== undefined)
+        body.is_active = is_active;
+    // Convert human-readable amount to raw if provided
+    if (amount !== undefined) {
+        const decimals = token_decimals ?? 6; // Default to USDC decimals
+        body.amount = parseUnits(amount, decimals);
+    }
+    const data = await api(`/x402/paywalls/${paywall_id}`, 'PUT', body);
+    return jsonResponse(data);
+});
+// ─── Tool: delete_paywall ───────────────────────────────────────
+server.tool('delete_paywall', 'Delete an x402 paywall. The access URL will return 404 after deletion.', {
+    paywall_id: z.number().int().describe('Paywall ID to delete'),
+}, async ({ paywall_id }) => {
+    const data = await api(`/x402/paywalls/${paywall_id}`, 'DELETE');
+    return jsonResponse(data);
+});
+// ─── 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);
+});
+// ─── Tool: get_x402_revenue ─────────────────────────────────────
+server.tool('get_x402_revenue', 'Get aggregate x402 revenue statistics across all your paywalls. ' +
+    'Returns total payments and revenue broken down by chain and token.', {}, async () => {
+    const data = await api('/x402/revenue');
+    return jsonResponse(data);
+});
 // ─── Start ──────────────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentwallet-mcp",
-  "version": "1.3.0",
-  "description": "MCP server for AgentWallet — lets AI agents create wallets, sign transactions, broadcast on any EVM chain, and pay x402 invoices",
+  "version": "1.5.0",
+  "description": "MCP server for AgentWallet — lets AI agents create wallets, sign transactions, broadcast on any EVM chain, pay x402 invoices, and accept x402 payments",
   "type": "module",
   "main": "build/index.js",
   "bin": {