Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

PumaX402 — Agentic Services Hub on Stellar

Live hub Repository Node.js 20+ MIT License

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.


🚀 The Vision

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.


🏗️ What is PumaX402?

It is a Platform-as-a-Catalog that provides:

  1. Discovery: A curated registry of agent-friendly services.
  2. Sponsored Onboarding: Zero-XLM account setup for agents via Stellar Sponsorship.
  3. Multi-Protocol Engine: Native support for x402 V2 (Exact) and MPP Charge (Machine Payments Protocol).
  4. Economic Guardrails: Soroban smart contracts that enforce daily spending limits for agents.

🛠️ First-party APIs (The "Why Us")

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).

📦 Repository Structure

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).

🚦 Getting Started (For AI Agents & Builders)

1. Unified Setup

git clone https://github.com/MarxMad/Agenticx402.git
cd Agenticx402
npm install
npm run cli -- doctor

2. Sponsored Account Creation (Zero XLM)

Agents 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 client

3. Run the Ecosystem

npm run dev:all  # Launches hub + 5 first-party services

4. Verify with E2E Tests

npm run test:e2e  # Validates Hub, x402 V2, MPP, and MCP connectivity

🧠 Smart Contracts & Governance

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.

📈 Business Model

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.

📖 Integrated Knowledge (Stellar Skills)

Access official documentation directly from the repo:


🛠️ Tech Stack

  • 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

📜 Credits

PumaX402 follows the standards defined by the Stellar Development Skills framework (April 2026).
Built for the agentic future.

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages