Agentpay

AI Agent payment protocol on CKB Fiber Network. Zero-gas micropayments with Hold Invoice escrow.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "agentpay-2": {
      "command": "npx",
      "args": [
        "-y",
        "create-agentpay"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

AgentPay - BTC-Native AI Agent Payment Protocol

Give every AI Agent a wallet. Let Agents pay each other - instantly, with zero fees.

AgentPay is a BTC-native payment protocol designed for AI Agent economies. Built on CKB Fiber Network (Lightning-compatible L2), it enables:

Zero-gas micropayments - Pay per API call, no minimum amount
Hold Invoice escrow - Lock funds until service delivery is confirmed
BTC interoperability - Cross-chain payments via Lightning Network
MCP integration - Let Claude/GPT agents make payments natively

Quick Start

Install

Terminal

npm install @agentpay-dev/sdk @agentpay-dev/core

Create a Payment Agent

server.ts

import { AgentWallet } from '@agentpay-dev/sdk';

const wallet = new AgentWallet({ fiberRpcUrl: process.env.FIBER_RPC_URL });

// Pay another agent for a service
const result = await wallet.payAndCall(
  'https://translator-agent.example.com',
  'translate',
  { text: 'Hello World', target: 'zh' }
);

Scaffold a New Project

Terminal

npx create-agentpay my-agent
cd my-agent && npm install

Architecture

Code

+-----------------------------------------------------+
|                    Applications                      |
|  AI Agents  |  DePIN Devices  |  API Marketplaces    |
+-----------------------------------------------------+
|                   AgentPay SDK                       |
|  AgentWallet  |  ServiceProvider  |  HubClient       |
+-----------------------------------------------------+
|                   AgentPay Core                      |
|  Settlement  |  Metering  |  DID  |  Assets          |
+-----------------------------------------------------+
|              CKB Fiber Network (L2)                  |
|  Payment Channels  |  Hold Invoice  |  HTLC Routing  |
+-----------------------------------------------------+
|         CKB L1  +  BTC Lightning Network             |
|    xUDT Assets  |  RGB++  |  Cross-chain (Cch)       |
+-----------------------------------------------------+

Packages

Package	npm	Description
`@agentpay-dev/core`		Protocol core: Fiber RPC, settlement, assets, DePIN metering
`@agentpay-dev/sdk`		Developer SDK: AgentWallet, ServiceProvider, HubClient
`@agentpay-dev/mcp-server`		MCP Server: 8 payment tools for Claude/GPT
`@agentpay-dev/x402-facilitator`		HTTP 402 payment middleware with Fiber settlement
`@agentpay-dev/ap2`		Google AP2 protocol bridge to Fiber
`create-agentpay`		CLI scaffolding tool

Key Features

Hold Invoice - Trustless Escrow

The killer feature. Agent A locks payment, Agent B delivers, funds release only on confirmation:

server.ts

import { ServiceProvider } from '@agentpay-dev/sdk';

const provider = new ServiceProvider({
  fiberRpcUrl: process.env.FIBER_RPC_URL,
  services: {
    translate: {
      price: 100_000_000n,  // 1 CKB per request
      handler: async (params) => {
        const result = await doTranslation(params.text, params.target);
        return { translation: result };
      }
    }
  }
});

// Hold flow: Lock -> Deliver -> Release (atomic)
// If service fails, funds auto-refund via HTLC timeout

MCP Server - AI-Native Payments

Registered on the official MCP Registry as io.github.alefnt/agentpay.

Add to Claude Desktop config:

config.json

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["@agentpay-dev/mcp-server"],
      "env": { "FIBER_RPC_URL": "http://localhost:8227" }
    }
  }
}

8 MCP Tools:

Tool	Description
`get_balance`	Check wallet balance (CKB + xUDT)
`send_payment`	Send a payment via Fiber invoice
`create_invoice`	Generate a Fiber invoice to receive payment
`pay_for_service`	Pay-and-call another agent's API
`create_hold_invoice`	Create escrow payment (lock funds)
`settle_hold`	Release held funds after service delivery
`cancel_hold`	Cancel and refund held payment
`list_channels`	View active payment channels

x402 HTTP Compatibility

Any HTTP API becomes a paid API with one middleware:

server.ts

import { createX402Middleware } from '@agentpay-dev/x402-facilitator';

const paywall = createX402Middleware({ price: '100000000' });

http.createServer((req, res) => {
  paywall(req, res, () => {
    res.end(JSON.stringify({ data: 'premium content' }));
  });
});
// Client: HTTP 402 -> pay Fiber invoice -> retry -> get content

BTC Cross-Chain

Pay with BTC, settle on CKB via Lightning-Fiber bridge:

server.ts

import { CchClient } from '@agentpay-dev/core';

const cch = new CchClient({ cchRpcUrl: process.env.CCH_RPC_URL });

await cch.sendBtcToCkb({
  btcPayReq: 'lnbc100n1p...',
  fiberChannelId: '0x...',
});

Ecosystem Integration

AgentPay enhances existing payment solutions:

Platform	How AgentPay Helps
x402 (Coinbase)	Zero-gas Fiber settlement backend for HTTP 402 protocol
AP2 (Google)	Settlement layer for agent authorization framework
Stripe	Complements with agent-to-agent micropayments (sub-cent)
Lightning Network	Cross-chain via Cch bridge, expanding BTC payment reach

Project Structure

Code

AgentPay/
  packages/
    core/               # Protocol core (Fiber RPC, settlement, DePIN)
    sdk/                # Developer SDK (Wallet, Provider, Hub)
    mcp-server/         # MCP Server for AI agents
    x402-facilitator/   # HTTP 402 middleware
    ap2/                # Google AP2 bridge
    create-agentpay/    # CLI scaffolding
  services/
    hub/                # Hosted wallet service
    registry/           # Agent discovery service
  examples/
    translate-agent/    # Translation service example
    code-review-agent/  # Code review agent example
    btc-to-ckb/         # Cross-chain payment example
  docs/
    product.md          # Product overview
    architecture.md     # Technical architecture

Documentation

Product Overview - What AgentPay solves and how
Architecture - Technical design and protocol layers
Competitive Analysis - Comparison with x402, AP2, Stripe

Tech Stack

Runtime: Node.js 20+ / TypeScript 5.5+
L2 Network: CKB Fiber Network (Lightning-compatible)
L1 Blockchain: Nervos CKB
Asset Standard: xUDT (extensible User Defined Token)
Identity: .bit decentralized identity
Cross-chain: Cch (CKB - BTC Lightning bridge)
AI Integration: Model Context Protocol (MCP)
Build: pnpm workspace monorepo

Development

bash

git clone https://github.com/alefnt/AgentPay.git
cd AgentPay
pnpm install
pnpm build
pnpm test

Roadmap

License

MIT - see LICENSE for details.

Built for the Agent Economy - where AI agents autonomously discover, negotiate, and pay for services.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Agentpay

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "agentpay": { "command": "npx", "args": ["-y","create-agentpay"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/agentpay-2?style=directory)](https://allmcps.com/mcp/agentpay-2)

HTML Embed

<a href="https://allmcps.com/mcp/agentpay-2"><img src="https://allmcps.com/api/badge/agentpay-2?style=directory" alt="Agentpay on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

7/10 checks healthy over the last 45d

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity0/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · create-agentpay (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Agentpay →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Agentpay

AI Agent payment protocol on CKB Fiber Network. Zero-gas micropayments with Hold Invoice escrow.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "agentpay-2": {
      "command": "npx",
      "args": [
        "-y",
        "create-agentpay"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

AgentPay - BTC-Native AI Agent Payment Protocol

Give every AI Agent a wallet. Let Agents pay each other - instantly, with zero fees.

AgentPay is a BTC-native payment protocol designed for AI Agent economies. Built on CKB Fiber Network (Lightning-compatible L2), it enables:

Zero-gas micropayments - Pay per API call, no minimum amount
Hold Invoice escrow - Lock funds until service delivery is confirmed
BTC interoperability - Cross-chain payments via Lightning Network
MCP integration - Let Claude/GPT agents make payments natively

Quick Start

Install

Terminal

npm install @agentpay-dev/sdk @agentpay-dev/core

Create a Payment Agent

server.ts

import { AgentWallet } from '@agentpay-dev/sdk';

const wallet = new AgentWallet({ fiberRpcUrl: process.env.FIBER_RPC_URL });

// Pay another agent for a service
const result = await wallet.payAndCall(
  'https://translator-agent.example.com',
  'translate',
  { text: 'Hello World', target: 'zh' }
);

Scaffold a New Project

Terminal

npx create-agentpay my-agent
cd my-agent && npm install

Architecture

Code

+-----------------------------------------------------+
|                    Applications                      |
|  AI Agents  |  DePIN Devices  |  API Marketplaces    |
+-----------------------------------------------------+
|                   AgentPay SDK                       |
|  AgentWallet  |  ServiceProvider  |  HubClient       |
+-----------------------------------------------------+
|                   AgentPay Core                      |
|  Settlement  |  Metering  |  DID  |  Assets          |
+-----------------------------------------------------+
|              CKB Fiber Network (L2)                  |
|  Payment Channels  |  Hold Invoice  |  HTLC Routing  |
+-----------------------------------------------------+
|         CKB L1  +  BTC Lightning Network             |
|    xUDT Assets  |  RGB++  |  Cross-chain (Cch)       |
+-----------------------------------------------------+

Packages

Package	npm	Description
`@agentpay-dev/core`		Protocol core: Fiber RPC, settlement, assets, DePIN metering
`@agentpay-dev/sdk`		Developer SDK: AgentWallet, ServiceProvider, HubClient
`@agentpay-dev/mcp-server`		MCP Server: 8 payment tools for Claude/GPT
`@agentpay-dev/x402-facilitator`		HTTP 402 payment middleware with Fiber settlement
`@agentpay-dev/ap2`		Google AP2 protocol bridge to Fiber
`create-agentpay`		CLI scaffolding tool

Key Features

Hold Invoice - Trustless Escrow

The killer feature. Agent A locks payment, Agent B delivers, funds release only on confirmation:

server.ts

import { ServiceProvider } from '@agentpay-dev/sdk';

const provider = new ServiceProvider({
  fiberRpcUrl: process.env.FIBER_RPC_URL,
  services: {
    translate: {
      price: 100_000_000n,  // 1 CKB per request
      handler: async (params) => {
        const result = await doTranslation(params.text, params.target);
        return { translation: result };
      }
    }
  }
});

// Hold flow: Lock -> Deliver -> Release (atomic)
// If service fails, funds auto-refund via HTLC timeout

MCP Server - AI-Native Payments

Registered on the official MCP Registry as io.github.alefnt/agentpay.

Add to Claude Desktop config:

config.json

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["@agentpay-dev/mcp-server"],
      "env": { "FIBER_RPC_URL": "http://localhost:8227" }
    }
  }
}

8 MCP Tools:

Tool	Description
`get_balance`	Check wallet balance (CKB + xUDT)
`send_payment`	Send a payment via Fiber invoice
`create_invoice`	Generate a Fiber invoice to receive payment
`pay_for_service`	Pay-and-call another agent's API
`create_hold_invoice`	Create escrow payment (lock funds)
`settle_hold`	Release held funds after service delivery
`cancel_hold`	Cancel and refund held payment
`list_channels`	View active payment channels

x402 HTTP Compatibility

Any HTTP API becomes a paid API with one middleware:

server.ts

import { createX402Middleware } from '@agentpay-dev/x402-facilitator';

const paywall = createX402Middleware({ price: '100000000' });

http.createServer((req, res) => {
  paywall(req, res, () => {
    res.end(JSON.stringify({ data: 'premium content' }));
  });
});
// Client: HTTP 402 -> pay Fiber invoice -> retry -> get content

BTC Cross-Chain

Pay with BTC, settle on CKB via Lightning-Fiber bridge:

server.ts

import { CchClient } from '@agentpay-dev/core';

const cch = new CchClient({ cchRpcUrl: process.env.CCH_RPC_URL });

await cch.sendBtcToCkb({
  btcPayReq: 'lnbc100n1p...',
  fiberChannelId: '0x...',
});

Ecosystem Integration

AgentPay enhances existing payment solutions:

Platform	How AgentPay Helps
x402 (Coinbase)	Zero-gas Fiber settlement backend for HTTP 402 protocol
AP2 (Google)	Settlement layer for agent authorization framework
Stripe	Complements with agent-to-agent micropayments (sub-cent)
Lightning Network	Cross-chain via Cch bridge, expanding BTC payment reach

Project Structure

Code

AgentPay/
  packages/
    core/               # Protocol core (Fiber RPC, settlement, DePIN)
    sdk/                # Developer SDK (Wallet, Provider, Hub)
    mcp-server/         # MCP Server for AI agents
    x402-facilitator/   # HTTP 402 middleware
    ap2/                # Google AP2 bridge
    create-agentpay/    # CLI scaffolding
  services/
    hub/                # Hosted wallet service
    registry/           # Agent discovery service
  examples/
    translate-agent/    # Translation service example
    code-review-agent/  # Code review agent example
    btc-to-ckb/         # Cross-chain payment example
  docs/
    product.md          # Product overview
    architecture.md     # Technical architecture

Documentation

Product Overview - What AgentPay solves and how
Architecture - Technical design and protocol layers
Competitive Analysis - Comparison with x402, AP2, Stripe

Tech Stack

Runtime: Node.js 20+ / TypeScript 5.5+
L2 Network: CKB Fiber Network (Lightning-compatible)
L1 Blockchain: Nervos CKB
Asset Standard: xUDT (extensible User Defined Token)
Identity: .bit decentralized identity
Cross-chain: Cch (CKB - BTC Lightning bridge)
AI Integration: Model Context Protocol (MCP)
Build: pnpm workspace monorepo

Development

bash

git clone https://github.com/alefnt/AgentPay.git
cd AgentPay
pnpm install
pnpm build
pnpm test

Roadmap

License

MIT - see LICENSE for details.

Built for the Agent Economy - where AI agents autonomously discover, negotiate, and pay for services.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Agentpay

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "agentpay": { "command": "npx", "args": ["-y","create-agentpay"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/agentpay-2?style=directory)](https://allmcps.com/mcp/agentpay-2)

HTML Embed

<a href="https://allmcps.com/mcp/agentpay-2"><img src="https://allmcps.com/api/badge/agentpay-2?style=directory" alt="Agentpay on AllMCPs" /></a>