A unified catalog and access layer for x402 and MPP services on Stellar: discover, pay per request, and consume APIs with a single mental model—designed for AI agents and machine-to-machine (M2M) economies.
Agents can reason, plan, and act—until they hit a paywall. PumaX402 removes this barrier by providing a standardized infrastructure where agents can find paid tools, receive sponsored funding, and execute micropayments using USDC or EURC in seconds.
It is a Platform-as-a-Catalog that provides:
- Discovery: A curated registry of agent-friendly services.
- Sponsored Onboarding: Zero-XLM account setup for agents via Stellar Sponsorship.
- Multi-Protocol Engine: Native support for x402 V2 (Exact) and MPP Charge (Machine Payments Protocol).
- Economic Guardrails: Soroban smart contracts that enforce daily spending limits for agents.
We maintain flagship services that demonstrate the power of agentic payments on Stellar:
| Service | Catalog ID | Value for Agents |
|---|---|---|
| Agent Pulse | pumax402-agent-pulse |
Packaged network context (ledgers, fees, hints) to prevent agent hallucinations. |
| DEX Signal | pumax402-stellar-dex-signal |
High-speed trading signals from Horizon/SDEX with consistent schemas. |
| Geo-Risk | pumax402-geopolitical-risk |
Orchestrated risk signal aggregating multiple data sources into one paid call. |
| Energy Signal | pumax402-energy-signal |
LLM-powered (Groq) or heuristic signals for energy resource management. |
| MPP Reference | pumax402-mpp-service |
Direct M2M payment demo using the Charge protocol (reference implementation). |
| Layer | Path | Description |
|---|---|---|
| UI | apps/catalog-web |
Aesthetic, responsive dashboard with real-time activity log. |
| API | apps/catalog-api |
REST discovery layer & Activity SSE stream. |
| CLI | apps/cli |
Professional toolset: doctor, list, fetch, call. |
| MCP | apps/mcp |
Stdio server for AI agents (Claude Code, Cursor) with advanced tools. |
| Contracts | soroban/contracts |
Smart contracts for Trustlines and Daily Spending Limits. |
| Skill | skill/ |
Integrated Stellar development playbook (Knowledge base). |
git clone https://github.com/MarxMad/Agenticx402.git
cd Agenticx402
npm install
npm run cli -- doctorAgents don't need XLM to start. Use our MCP tool or the internal sponsorship logic:
# Set your hub keys in .env
npm run mcp
# Access 'sponsor_agent_account' via your AI clientnpm run dev:all # Launches hub + 5 first-party servicesnpm run test:e2e # Validates Hub, x402 V2, MPP, and MCP connectivity| Contract | Purpose |
|---|---|
spending_limit |
Enforces a daily USDC limit so your agent doesn't overspend. |
hello_trustline |
Modern constructor pattern (Protocol 22+) for setting up agent trusts. |
PumaX402 is designed for sustainability:
- Take Rate: Small percentage on transaction volume.
- Provider SaaS: Analytics and search priority for API vendors.
- Enterprise Governance: Custom budgets and audit logs for agent fleets.
Full details:
BUSINESS_MODEL.md.
Access official documentation directly from the repo:
- Runtime: Node.js 20+ (ESM)
- Stellar:
stellar-sdk,stellar-cli, Soroban (Rust) - Payments:
@x402/core,@x402/stellar,@x402/express - Agents: Model Context Protocol (MCP)
- UI: Vanilla HTML/JS/CSS
PumaX402 follows the standards defined by the Stellar Development Skills framework (April 2026).
Built for the agentic future.