{
  "markdown": "<div align=\"center\">\n\n<img src=\"site/public/og.png\" alt=\"PipRail — the payment layer for the agent economy\" width=\"840\" />\n\n<br/>\n<br/>\n\n[![@piprail/sdk](https://img.shields.io/npm/v/@piprail/sdk.svg?logo=npm&label=%40piprail%2Fsdk&color=cb3837)](https://www.npmjs.com/package/@piprail/sdk)\n[![@piprail/mcp](https://img.shields.io/npm/v/@piprail/mcp.svg?logo=npm&label=%40piprail%2Fmcp&color=2ee6a6)](https://www.npmjs.com/package/@piprail/mcp)\n[![types](https://img.shields.io/npm/types/@piprail/sdk.svg?logo=typescript&logoColor=white&color=3178c6)](https://www.npmjs.com/package/@piprail/sdk)\n[![license](https://img.shields.io/github/license/piprail/piprail.svg?color=2ee6a6)](LICENSE)\n[![x402 v2](https://img.shields.io/badge/x402-v2-6e56cf.svg)](https://x402.org)\n[![chains](https://img.shields.io/badge/chains-29%20across%2010%20families-2ee6a6.svg)](https://docs.piprail.com/chains/overview/)\n[![GitHub stars](https://img.shields.io/github/stars/piprail/piprail?style=flat&logo=github&label=Star&color=2ee6a6)](https://github.com/piprail/piprail)\n[![Follow @piprailhq](https://img.shields.io/badge/Follow-%40piprailhq-1d9bf0?logo=x&logoColor=white)](https://x.com/piprailhq)\n\n**Let any HTTP endpoint charge for itself, and any agent pay for itself — across every major chain, in a couple of lines.**\n\n[Website](https://piprail.com) · [Documentation](https://docs.piprail.com) · [npm](https://www.npmjs.com/package/@piprail/sdk)\n\n</div>\n\n---\n\nPipRail implements the open [x402](https://x402.org) **\"402 Payment Required\"** standard with **no backend, no database, no account, no API key, and no fee**. Payments settle **straight into your wallet**, verified locally against your own RPC — across every major EVM chain plus **Solana, TON, Tron, NEAR, Sui, Aptos, Algorand, Stellar & the XRP Ledger**. Self-custodial throughout.\n\n## How a payment moves\n\n<div align=\"center\">\n\n<img src=\"site/public/flow.png\" alt=\"How a payment moves — the full life of one payment, side by side. Left, the traditional MPP path (Stripe + Tempo): the agent's money is held in transit through a processor and a permissioned chain across roughly five hops, takes ~T+2 days to become spendable, and can be frozen or reversed. Right, PipRail's x402 wallet-to-wallet rail: the agent pays the merchant's wallet directly in a single on-chain transaction, the merchant gate verifies it locally, funds are spendable in seconds, there's no custodian, and the fee is 0%.\" width=\"840\" />\n\n<sub>**The middle is the difference.** A traditional processor holds the money in transit, takes days to release it, and can freeze or reverse it. PipRail removes the middle entirely — the agent pays the merchant's wallet directly, the merchant verifies it locally against their own RPC, and it settles in one transaction at **0% fee**, self-custodial end to end. &nbsp;<a href=\"https://piprail.com\">See it on piprail.com →</a></sub>\n\n</div>\n\n## 📊 The pitch deck\n\n<div align=\"center\">\n\n<a href=\"PipRail-deck.pdf\"><img src=\".claude/skills/branding/design/deck/preview/slide-01.png\" alt=\"PipRail pitch deck — the universal payment rail for the agent economy. Click to open the full 16-slide PDF, rendered right here in your browser.\" width=\"840\" /></a>\n\n### ▶︎ &nbsp;[**Open the full deck — PDF**](PipRail-deck.pdf) &nbsp;◀︎\n\n<sub>Opens **right here in your browser** — no download, GitHub renders it inline. 16 slides · every stat sourced in the speaker notes.</sub>\n\n</div>\n\nThe whole thesis in one read: **why** agent payments are happening now, **why** chain & token fragmentation is the enemy, and **how** a single `chain:` parameter turns PipRail into the universal adapter. The payment path is **0% forever** — the moat *and* the distribution; value accrues to the layer around the free rail, never the rail itself.\n\n<details>\n<summary><b>What's inside — the 16-slide arc</b></summary>\n\n<br/>\n\n| # | Slide | # | Slide |\n|---|---|---|---|\n| 1 | **Hero** — the universal payment rail for the agent economy | 9 | **The MCP** — give your agent a budget-bound wallet |\n| 2 | **Why now** — money is moving on-chain | 10 | **Open · dual-rail · gasless** |\n| 3 | **The new buyer** — autonomous agents | 11 | **MPP vs PipRail** — count the middlemen |\n| 4 | **The standard** — x402, \"402 Payment Required\" | 12 | **Discovery + integrations** |\n| 5 | **The problem** — chain & token fragmentation | 13 | **Why PipRail wins** — the moat |\n| 6 | **The reveal** — the universal adapter | 14 | **Traction** |\n| 7 | **How it works** — 402 → pay → verify → 200 | 15 | **Business model** — open core, 0% rail |\n| 8 | **Two sides, one SDK** — accept *and* pay | 16 | **The ask** |\n\n<sub>Source `.pptx` (fully editable, brand fonts embedded) lives in [`.claude/skills/branding/design/deck/`](.claude/skills/branding/design/deck/). The root `PipRail-deck.pdf` is regenerated from it — don't hand-edit the PDF.</sub>\n\n</details>\n\n> ### 📖 Full documentation → **[docs.piprail.com](https://docs.piprail.com)**\n> The single, searchable **source of truth** — every function, option, chain, and example. This README is just the front door.\n\n## What's here\n\n| | |\n|---|---|\n| **[`@piprail/sdk`](https://www.npmjs.com/package/@piprail/sdk)** | The TypeScript SDK — accept & make x402 payments. The product. |\n| **[`@piprail/mcp`](https://www.npmjs.com/package/@piprail/mcp)** | An MCP server giving any AI agent a budget-bound wallet ([`io.github.piprail/mcp`](https://registry.modelcontextprotocol.io)). |\n| **[`@piprail/create`](https://www.npmjs.com/package/@piprail/create)** | `npm create @piprail` — scaffolds a runnable, mainnet-by-default x402 merchant in one command. Paste a public address; no key, no backend. |\n| **[`integrations/`](integrations)** | First-party agent-framework integrations — **OpenClaw**, **Hermes**, **elizaOS** (`@piprail/elizaos-plugin`), **n8n** (`@piprail/n8n-nodes-piprail`) & **Mastra**. Each wraps `@piprail/sdk` or `@piprail/mcp`; nothing new to build. |\n| **[`site/`](site)** · **[`docs/`](docs)** · **[`examples/`](examples)** | [piprail.com](https://piprail.com) · the [docs.piprail.com](https://docs.piprail.com) source · runnable demos. |\n\n## Quick taste\n\n```bash\nnpm install @piprail/sdk viem\n```\n\n```ts\nimport { requirePayment } from '@piprail/sdk'\n\napp.get('/report',\n  requirePayment({ chain: 'base', token: 'USDC', amount: '0.05', payTo: '0xYourWallet…' }),\n  (_req, res) => res.json({ report: 'TOP SECRET' }),\n)\n```\n\nThat route now costs **0.05 USDC on Base**, paid straight to your wallet. Point an agent at it and it pays itself — name any chain with a single `chain:` parameter. The full quickstart, every chain, the MCP server, spend controls, and the error model are in the **[docs](https://docs.piprail.com)**.\n\n## Documentation & links\n\n- **[docs.piprail.com](https://docs.piprail.com)** — the complete manual (source of truth)\n- **[MCP server](https://docs.piprail.com/mcp/overview/)** · **[Discovery](https://docs.piprail.com/discovery/discover-and-register/)** · **[Supported chains](https://docs.piprail.com/chains/overview/)**\n- **[Integrations](https://docs.piprail.com/integrations/)** — drop PipRail into agent frameworks: [OpenClaw](integrations/openclaw/piprail), [Hermes](integrations/hermes/piprail), [elizaOS](integrations/elizaos/piprail), [n8n](integrations/n8n/piprail) & [Mastra](integrations/mastra/piprail) (more coming)\n- **[Runnable examples](examples)** — merchant + agent demos, a live Anvil end-to-end, and the [`why-402`](examples/basics/why-402/) teardown\n- **[Releasing](RELEASING.md)** (tag-driven CI) · **[Contributing](CONTRIBUTING.md)** (DCO)\n\n## Spread the word\n\nPipRail is free, open-source, and has no backend to sell you — so word of mouth is how it grows. If it saved you from building a payments backend, the best way to give back is to help other developers (and their agents) find it:\n\n- ⭐ **[Star PipRail on GitHub](https://github.com/piprail/piprail)** — the #1 way to help others discover it\n- 𝕏 **[Follow @piprailhq](https://x.com/piprailhq)** — new chains, ship logs, and agent-payment tips\n- 🌐 **[piprail.com](https://piprail.com)** · 📖 **[docs.piprail.com](https://docs.piprail.com)**\n\n## License & trademark\n\n**Code:** [MIT](LICENSE) — use it, fork it, ship it, commercially or otherwise.\n\n**Name & brand:** **PipRail™**, the logo, and the `@piprail` npm scope are trademarks of the PipRail project — MIT covers the *code*, not the *name*. Build on it freely; just don't call a fork \"PipRail\" or imply it's official. See [TRADEMARK.md](TRADEMARK.md).\n\n<div align=\"center\">\n<br/>\n<img src=\"site/public/logo.png\" alt=\"PipRail\" width=\"64\" />\n\n<sub>Built for the agent economy · <a href=\"https://piprail.com\">piprail.com</a></sub>\n</div>\n",
  "bytes": 8684,
  "sha": "eb083bf1265783db6798ff233384d110056a9af712de4f76d8cdfc89eff2e2b6",
  "repo_slug": "piprail/piprail",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_piprail_mcp_f08d7298/readme"
}