{ "markdown": "# Agentic Pay \"agentic-pay-avatar\"\n\n\nA cross-platform payment engine that lets third-party AI agents send and\nreceive payments over seven crypto rails: **BTC, ETH, USDT, USDC, XRP,\nXMR, ZEC**.\n\nOne Node.js core runs unmodified on **Linux, Windows, and macOS**. The same\nbackend is reachable from **iOS and Android** via an installable Progressive\nWeb App (PWA) — there is no separate native mobile codebase to maintain.\n\n## Architecture\n\n```\n ┌───────────────────────────┐\n │ core/railManager.js │ <- one call-site for\n │ (policy + ledger + auth) │ every asset\n └─────────────┬─────────────┘\n │\n ┌───────────┬─────────────┼─────────────┬───────────┬──────────┐\n │ │ │ │ │ │\n rails/btc rails/eth rails/xrp rails/xmr rails/zec │\n (bitcoinjs) (ethers.js, (xrpl.js) (JSON-RPC to (JSON-RPC to │\n ETH+USDT+ monero- zcashd) │\n USDC ERC20) wallet-rpc) │\n │\n Agent-facing surfaces (both call railManager, never a rail │\n adapter directly): │\n ┌────────────────────────┐ ┌───────────────────────────┐ │\n │ server/restApi.js │ │ server/mcpServer.mjs │ │\n │ HTTP/JSON, API-key │ │ MCP stdio server for │ │\n │ auth, for any HTTP- │ │ Claude / other MCP- │ │\n │ capable agent stack │ │ compatible agent clients │ │\n └────────────────────────┘ └───────────────────────────┘ │\n │\n Human-facing surfaces: │\n ┌────────────────────────┐ ┌───────────────────────────┐ │\n │ cli/index.js │ │ web/ (PWA) │ │\n │ Linux/Windows/macOS │ │ served by server/ │ │\n │ terminal │ │ staticWeb.js, installable │ │\n │ │ │ on iOS/Android home screen │ │\n └────────────────────────┘ └───────────────────────────┘ │\n```\n\nEvery send, from any surface, passes through `core/limits.js` (per-agent\nspend caps + human-confirmation floor) and `core/ledger.js` (idempotency,\nso a retried tool call can never double-pay).\n\n## Quick start (any OS with Node.js 18+)\n\n```bash\ngit clone # or unzip the delivered archive\ncd agentic-pay\nnpm install\n\ncp config/.env.example .env\ncp config/config.example.json config/config.json\n# edit both files — see docs/SETUP_.md for exact values per rail\n\nnpm run start:rest # REST API on :8787\nnpm run start:web # PWA on :8788 (optional, for mobile/browser access)\nnpm run start:mcp # MCP stdio server (for Claude Desktop / Claude Code)\nnode cli/index.js rails # sanity check from the terminal\n```\n\n**Start on testnets first.** Every rail's example config defaults to a\ntestnet or requires you to explicitly fill in mainnet values — this is\nintentional. Do not point real funds at this system until you've reviewed\n`core/limits.js` and set spend caps you're comfortable with.\n\n## Hosted (custodial) — skip the setup\n\nDon't want to run your own node? Aumnium operates a hosted instance at\n**https://api.aumnium.tech** — deposit USDC, get a spendable custodial\nbalance, and start sending across all seven rails without installing or\nfunding anything yourself.\n\nThis is a **different trust model** than the self-hosted instructions\nabove: your funds sit in a pooled wallet operated by Aumnium (not your\nown keys), and each send is charged a 1% fee plus network cost, deducted\nfrom your balance. The self-hosted path above remains fully non-custodial;\nthis hosted path trades that for convenience.\n\n```bash\n# 1. Get your deposit address\ncurl -H \"x-api-key: YOUR_KEY\" https://api.aumnium.tech/v1/deposit/address\n\n# 2. Send USDC to that address on Ethereum mainnet\n\n# 3. Claim your deposit once it confirms\ncurl -X POST -H \"x-api-key: YOUR_KEY\" -H \"Content-Type: application/json\" \\\n -d \\'{\"txHash\":\"0x...\"}\\' \\\n https://api.aumnium.tech/v1/deposit/claim\n\n# 4. Send payments (billed per-call via x402, USDC on Base)\ncurl -X POST -H \"x-api-key: YOUR_KEY\" -H \"Content-Type: application/json\" \\\n -d \\'{\"asset\":\"USDC\",\"to\":\"0x...\",\"amount\":1,\"idempotencyKey\":\"unique-key\"}\\' \\\n https://api.aumnium.tech/v1/send\n```\n\nContact team@spacenet.network for an API key. Full endpoint list at\n[https://api.aumnium.tech](https://api.aumnium.tech).\n\n## Where to go next\n\n- [`docs/SETUP_LINUX.md`](docs/SETUP_LINUX.md)\n- [`docs/SETUP_WINDOWS.md`](docs/SETUP_WINDOWS.md)\n- [`docs/SETUP_MACOS.md`](docs/SETUP_MACOS.md)\n- [`docs/SETUP_MOBILE.md`](docs/SETUP_MOBILE.md) — iOS and Android via PWA\n- [`docs/AGENT_INTEGRATION.md`](docs/AGENT_INTEGRATION.md) — wiring up\n Claude, MCP clients, or any HTTP-based agent framework\n- [`docs/SECURITY.md`](docs/SECURITY.md) — key management, spend limits,\n and legal/regulatory considerations — **read this before sending real\n funds**\n\n## What's genuinely production-ready here vs. what's a starting point\n\n- **Production-shaped:** the policy engine (per-tx cap, daily cap,\n confirmation floor, address allowlisting), the idempotent ledger, and\n the unified rail interface.\n- **Starting point, needs hardening for real money at scale:** the\n JSON-file ledger (swap for a real database under load), the static\n USD price table (wire in a live price feed), and key storage (move\n from `.env` to an OS keychain or HSM/KMS for anything beyond\n development — see `core/keystore.js` for the extension point).\n\n## License\n\nagentic-pay is licensed under the **Business Source License 1.1** (see\n[`LICENSE`](LICENSE)). In plain terms:\n\n- You can use, modify, and self-host this freely — for yourself, your\n own organization, or your own agents, including production use.\n- You **cannot** turn around and offer it as a competing hosted/managed\n payments-as-a-service product to third parties without a commercial\n license.\n- On **2030-07-14**, this version automatically converts to the Apache\n License 2.0 — fully open source, no restrictions.\n\nWant a commercial license for a hosted/managed offering before then?\nContact team@spacenet.network.\n\n\n", "bytes": 6690, "sha": "088aa6b41e42d4479cf3b03ea96b80a62d97e0af49f36309d47526775fd0247e", "repo_slug": "shieldcubed/agentic-pay", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_shieldcubed_agentic_pay_f46f2a77/readme" }