{
  "markdown": "# AgentPay - BTC-Native AI Agent Payment Protocol\n\n[![npm](https://img.shields.io/npm/v/@agentpay-dev/core?label=%40agentpay-dev%2Fcore)](https://www.npmjs.com/package/@agentpay-dev/core)\n[![npm](https://img.shields.io/npm/v/@agentpay-dev/sdk?label=%40agentpay-dev%2Fsdk)](https://www.npmjs.com/package/@agentpay-dev/sdk)\n[![npm](https://img.shields.io/npm/v/@agentpay-dev/mcp-server?label=MCP%20Server)](https://www.npmjs.com/package/@agentpay-dev/mcp-server)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.alefnt%2Fagentpay-blue)](https://registry.modelcontextprotocol.io/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n> **Give every AI Agent a wallet. Let Agents pay each other - instantly, with zero fees.**\n\nAgentPay is a **BTC-native payment protocol** designed for AI Agent economies. Built on [CKB Fiber Network](https://fiber.nervos.org/) (Lightning-compatible L2), it enables:\n\n- **Zero-gas micropayments** - Pay per API call, no minimum amount\n- **Hold Invoice escrow** - Lock funds until service delivery is confirmed\n- **BTC interoperability** - Cross-chain payments via Lightning Network\n- **MCP integration** - Let Claude/GPT agents make payments natively\n\n## Quick Start\n\n### Install\n\n```bash\nnpm install @agentpay-dev/sdk @agentpay-dev/core\n```\n\n### Create a Payment Agent\n\n```typescript\nimport { AgentWallet } from '@agentpay-dev/sdk';\n\nconst wallet = new AgentWallet({ fiberRpcUrl: process.env.FIBER_RPC_URL });\n\n// Pay another agent for a service\nconst result = await wallet.payAndCall(\n  'https://translator-agent.example.com',\n  'translate',\n  { text: 'Hello World', target: 'zh' }\n);\n```\n\n### Scaffold a New Project\n\n```bash\nnpx create-agentpay my-agent\ncd my-agent && npm install\n```\n\n## Architecture\n\n```\n+-----------------------------------------------------+\n|                    Applications                      |\n|  AI Agents  |  DePIN Devices  |  API Marketplaces    |\n+-----------------------------------------------------+\n|                   AgentPay SDK                       |\n|  AgentWallet  |  ServiceProvider  |  HubClient       |\n+-----------------------------------------------------+\n|                   AgentPay Core                      |\n|  Settlement  |  Metering  |  DID  |  Assets          |\n+-----------------------------------------------------+\n|              CKB Fiber Network (L2)                  |\n|  Payment Channels  |  Hold Invoice  |  HTLC Routing  |\n+-----------------------------------------------------+\n|         CKB L1  +  BTC Lightning Network             |\n|    xUDT Assets  |  RGB++  |  Cross-chain (Cch)       |\n+-----------------------------------------------------+\n```\n\n## Packages\n\n| Package | npm | Description |\n|---------|-----|-------------|\n| [`@agentpay-dev/core`](packages/core) | [![npm](https://img.shields.io/npm/v/@agentpay-dev/core)](https://www.npmjs.com/package/@agentpay-dev/core) | Protocol core: Fiber RPC, settlement, assets, DePIN metering |\n| [`@agentpay-dev/sdk`](packages/sdk) | [![npm](https://img.shields.io/npm/v/@agentpay-dev/sdk)](https://www.npmjs.com/package/@agentpay-dev/sdk) | Developer SDK: AgentWallet, ServiceProvider, HubClient |\n| [`@agentpay-dev/mcp-server`](packages/mcp-server) | [![npm](https://img.shields.io/npm/v/@agentpay-dev/mcp-server)](https://www.npmjs.com/package/@agentpay-dev/mcp-server) | MCP Server: 8 payment tools for Claude/GPT |\n| [`@agentpay-dev/x402-facilitator`](packages/x402-facilitator) | [![npm](https://img.shields.io/npm/v/@agentpay-dev/x402-facilitator)](https://www.npmjs.com/package/@agentpay-dev/x402-facilitator) | HTTP 402 payment middleware with Fiber settlement |\n| [`@agentpay-dev/ap2`](packages/ap2) | [![npm](https://img.shields.io/npm/v/@agentpay-dev/ap2)](https://www.npmjs.com/package/@agentpay-dev/ap2) | Google AP2 protocol bridge to Fiber |\n| [`create-agentpay`](packages/create-agentpay) | [![npm](https://img.shields.io/npm/v/create-agentpay)](https://www.npmjs.com/package/create-agentpay) | CLI scaffolding tool |\n\n## Key Features\n\n### Hold Invoice - Trustless Escrow\n\nThe killer feature. Agent A locks payment, Agent B delivers, funds release only on confirmation:\n\n```typescript\nimport { ServiceProvider } from '@agentpay-dev/sdk';\n\nconst provider = new ServiceProvider({\n  fiberRpcUrl: process.env.FIBER_RPC_URL,\n  services: {\n    translate: {\n      price: 100_000_000n,  // 1 CKB per request\n      handler: async (params) => {\n        const result = await doTranslation(params.text, params.target);\n        return { translation: result };\n      }\n    }\n  }\n});\n\n// Hold flow: Lock -> Deliver -> Release (atomic)\n// If service fails, funds auto-refund via HTLC timeout\n```\n\n### MCP Server - AI-Native Payments\n\nRegistered on the [official MCP Registry](https://registry.modelcontextprotocol.io/) as `io.github.alefnt/agentpay`.\n\nAdd to Claude Desktop config:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentpay\": {\n      \"command\": \"npx\",\n      \"args\": [\"@agentpay-dev/mcp-server\"],\n      \"env\": { \"FIBER_RPC_URL\": \"http://localhost:8227\" }\n    }\n  }\n}\n```\n\n**8 MCP Tools:**\n\n| Tool | Description |\n|------|-------------|\n| `get_balance` | Check wallet balance (CKB + xUDT) |\n| `send_payment` | Send a payment via Fiber invoice |\n| `create_invoice` | Generate a Fiber invoice to receive payment |\n| `pay_for_service` | Pay-and-call another agent's API |\n| `create_hold_invoice` | Create escrow payment (lock funds) |\n| `settle_hold` | Release held funds after service delivery |\n| `cancel_hold` | Cancel and refund held payment |\n| `list_channels` | View active payment channels |\n\n### x402 HTTP Compatibility\n\nAny HTTP API becomes a paid API with one middleware:\n\n```typescript\nimport { createX402Middleware } from '@agentpay-dev/x402-facilitator';\n\nconst paywall = createX402Middleware({ price: '100000000' });\n\nhttp.createServer((req, res) => {\n  paywall(req, res, () => {\n    res.end(JSON.stringify({ data: 'premium content' }));\n  });\n});\n// Client: HTTP 402 -> pay Fiber invoice -> retry -> get content\n```\n\n### BTC Cross-Chain\n\nPay with BTC, settle on CKB via Lightning-Fiber bridge:\n\n```typescript\nimport { CchClient } from '@agentpay-dev/core';\n\nconst cch = new CchClient({ cchRpcUrl: process.env.CCH_RPC_URL });\n\nawait cch.sendBtcToCkb({\n  btcPayReq: 'lnbc100n1p...',\n  fiberChannelId: '0x...',\n});\n```\n\n## Ecosystem Integration\n\nAgentPay enhances existing payment solutions:\n\n| Platform | How AgentPay Helps |\n|----------|-------------------|\n| **x402 (Coinbase)** | Zero-gas Fiber settlement backend for HTTP 402 protocol |\n| **AP2 (Google)** | Settlement layer for agent authorization framework |\n| **Stripe** | Complements with agent-to-agent micropayments (sub-cent) |\n| **Lightning Network** | Cross-chain via Cch bridge, expanding BTC payment reach |\n\n## Project Structure\n\n```\nAgentPay/\n  packages/\n    core/               # Protocol core (Fiber RPC, settlement, DePIN)\n    sdk/                # Developer SDK (Wallet, Provider, Hub)\n    mcp-server/         # MCP Server for AI agents\n    x402-facilitator/   # HTTP 402 middleware\n    ap2/                # Google AP2 bridge\n    create-agentpay/    # CLI scaffolding\n  services/\n    hub/                # Hosted wallet service\n    registry/           # Agent discovery service\n  examples/\n    translate-agent/    # Translation service example\n    code-review-agent/  # Code review agent example\n    btc-to-ckb/         # Cross-chain payment example\n  docs/\n    product.md          # Product overview\n    architecture.md     # Technical architecture\n```\n\n## Documentation\n\n- [Product Overview](docs/product.md) - What AgentPay solves and how\n- [Architecture](docs/architecture.md) - Technical design and protocol layers\n- [Competitive Analysis](docs/competitive-analysis.md) - Comparison with x402, AP2, Stripe\n\n## Tech Stack\n\n- **Runtime**: Node.js 20+ / TypeScript 5.5+\n- **L2 Network**: [CKB Fiber Network](https://fiber.nervos.org/) (Lightning-compatible)\n- **L1 Blockchain**: [Nervos CKB](https://nervos.org/)\n- **Asset Standard**: xUDT (extensible User Defined Token)\n- **Identity**: [.bit](https://did.id/) decentralized identity\n- **Cross-chain**: Cch (CKB - BTC Lightning bridge)\n- **AI Integration**: [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)\n- **Build**: pnpm workspace monorepo\n\n## Development\n\n```bash\ngit clone https://github.com/alefnt/AgentPay.git\ncd AgentPay\npnpm install\npnpm build\npnpm test\n```\n\n## Roadmap\n\n- [x] Core protocol (Fiber RPC, settlement, assets)\n- [x] SDK (AgentWallet, ServiceProvider, HubClient)\n- [x] MCP Server with 8 payment tools\n- [x] x402 HTTP 402 facilitator\n- [x] AP2 protocol bridge\n- [x] DePIN metering module\n- [x] BTC cross-chain (Cch + LND)\n- [x] RGB++ bridge integration\n- [x] npm packages published\n- [x] MCP Registry registration\n- [ ] Fiber mainnet deployment\n- [ ] Stablecoin (RUSD) support on CKB\n- [ ] Public demo site\n- [ ] Production Hub service\n\n## License\n\nMIT - see [LICENSE](LICENSE) for details.\n\n---\n\n**Built for the Agent Economy** - where AI agents autonomously discover, negotiate, and pay for services.\n",
  "bytes": 9072,
  "sha": "1b87e60fb2478545b5cce5a0cdcfd173154fb71824340f445df96ab81e05233a",
  "repo_slug": "alefnt/agentpay",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_alefnt_agentpay_e851d02e/readme"
}