Show off your agentic readiness — the badge auto-updates when your score changes.
llms.txt Content
# Loyal Spark — Onchain Loyalty Protocol
> Loyalty-as-a-Service for AI agents on Base L2. Create ERC-20 loyalty programs, mint tokens, earn points from purchases, manage rewards, trade on P2P marketplace — all via REST API (23 authenticated routes + 1 public GET), MCP Server (28 tools), MPP, or x402.
## 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)
- [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://bzxmejzssxjazswgwqqs.supabase.co/functions/v1/mpp-gateway
- Currency: USDC / pathUSD (Tempo)
- SDK: mppx (npm install -g mppx)
- Pricing: $0.001–$0.05 per request
### x402 (Coinbase Payment Protocol)
Pay per request with USDC on Base. Native HTTP 402 flow with on-chain settlement via Coinbase facilitator.
- Gateway: https://bzxmejzssxjazswgwqqs.supabase.co/functions/v1/x402-gateway
- Currency: USDC on Base (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
- Facilitator: https://facilitator.x402.org
- SDK: @x402/fetch, @x402/evm
- Pricing: Same as MPP ($0.001–$0.05 per request)
### API Key (Subscription)
Traditional API key authentication with monthly plans.
- Free: 200 calls/month, 1.25% mint fee
- Pro ($49/mo): 10K calls, 0.5% mint fee
- Enterprise ($129/mo): unlimited, 0.25% mint fee
Merchant SaaS (portal): Starter $39 / Growth $79 / Scale $149 per month — see site docs.
## Endpoints
### Read (GET) — $0.001–$0.005
- GET /programs — List loyalty programs
- GET /rewards — List rewards (with redemption metrics)
- GET /balance — Check token bala
OpenAPI Spec (preview)
{
"openapi": "3.1.0",
"info": {
"title": "Loyal Spark — Onchain Loyalty Protocol",
"version": "2.1.0",
"description": "AI-agent-native loyalty protocol on Base L2. REST: 23 authenticated routes plus public GET /vouchers/status. MCP: 28 tools at /loyalty-mcp. Create loyalty programs, mint tokens, POST /earn for purchase cashback, manage rewards, P2P marketplace, CDP server wallets.",
"x-guidance": "Loyal Spark — Base L2 (chain 8453).\n\nAuthentication: Almost every path re