Loyal Spark - Loyalty Rewards That Grow

# Loyal Spark — Onchain Loyalty Protocol > Loyalty-as-a-Service for AI agents on Base L2. **New programs deploy as B20** (Base native ERC-20 superset, 1 tx, active immediately). Legacy ERC-20 programs remain supported. Two agent personas: **merchants** (`lsk_`) issue loyalty tokens — REST 27 authenticated routes + 1 public GET, MCP 38 tools at /loyalty-mcp; **recipients** (`rwk_`) hold/spend tokens — REST 14 routes at /recipient-api, MCP 20 tools at /recipient-loyalty-mcp (incl. P2P offers and prepare_loyalty_token_transfer). Pay per call via MPP (pathUSD/USDC on Tempo) or x402 v2 (USDC on Base) — both gateways expose the same REST + MCP corridors with Coinbase Bazaar discovery metadata. ## Full Documentation: https://loyalspark.online/llms-full.txt ## Docs - [For AI agents (onboarding)](https://loyalspark.online/for-agents) - [API Documentation](https://loyalspark.online/api-docs) - [Skills Guide](https://loyalspark.online/.well-known/skills/index.md) - [Endpoint Workflows](https://loyalspark.online/.well-known/skills/13-endpoint-workflows.md) - [Agent Manifest](https://loyalspark.online/.well-known/agent.json) - [OpenAPI Spec](https://loyalspark.online/openapi.json) ## Payment Methods ### MPP (Machine Payments Protocol) Pay per request with USDC or pathUSD on Tempo chain. No API key required for payment, but agent identity (x-api-key) is needed for operations. - Gateway: https://api.loyalspark.online/mpp-gateway - Currency: USDC / pathUSD (Tempo) - SDK: mppx (npm install -g mppx) - Pricing: $0.001–$0.05 per request ### x402 (Coinbase Payment Protocol) — v2 Pay per request with USDC on Base. HTTP **402** with **x402 v2** `accepts` (CAIP-2 `eip155:8453`). Verify/settle on Base **mainnet** use **Coinbase CDP** (`https://api.cdp.coinbase.com/platform/v2/x402`) when the gateway is configured with CDP API keys (see repo `supabase/functions/x402-gateway`). - Gateway: https://api.loyalspark.online/x402-gateway - **Paid MCP (Bazaar-oriented metadata in 4

{ "openapi": "3.1.0", "info": { "title": "Loyal Spark \u2014 Onchain Loyalty Protocol on Base", "version": "2.3.1", "summary": "AI-agent-native loyalty-as-a-service protocol on Base L2 with paid x402 + MPP corridors.", "description": "Loyal Spark is an onchain loyalty-as-a-service protocol on Base L2. New loyalty programs deploy as B20 (Base native ERC-20 superset, single-tx, active immediately); legacy ERC-20 factory remains for existing programs. AI agents and merchants min