Reward Agent

A hosted AI agent for agentic loyalty — program management, purchase routing, and cross-brand commerce.

The Resonance Reward Agent is an ERC-8004 registered MCP server running on Cloudflare Workers. It exposes 45 tools across 17 modules via four access points — MCP, REST API, CLI, and A2A — enabling AI assistants, agents, and integrators to discover brands, route purchases, process rewards, analyze programs, and drive agentic commerce.

Access Points

Access Point	URL / Install	Best For
MCP	https://agent.rsnc.network/mcp	AI assistants (Claude, Cursor, ChatGPT)
REST API	https://agent.rsnc.network/api/v1/*	Direct HTTP integration, any language
CLI	npm install -g @resonance/cli	Terminal workflows, scripting, CI/CD
A2A	https://agent.rsnc.network/tasks/send	Agent-to-Agent protocol
Converse	POST /converse	Natural language queries (pro/enterprise)

How It Differs from the MCP Server

	MCP Server	Reward Agent
Transport	stdio (local process)	Streamable HTTP (remote)
Hosting	Your machine	Cloudflare Workers
Authentication	Brand ID only	HMAC-SHA256 + RFC 9421 Ed25519 + OAuth 2.0
Tools	30 (program design focused)	45 (operations + commerce + intelligence)
Access	MCP only	MCP + REST API + CLI + A2A
Best For	Development, program design	Production integrations, agentic commerce
Install	npm install	No install — connect via URL or npm i -g @resonance/cli
Protocol	MCP	MCP + ERC-8004 + A2A + UCP

Use the MCP Server when you're designing programs and need documentation access locally.

Use the Reward Agent when you need to operate across brands, route purchases, process real rewards, or build automated AI workflows.

What Can the Agent Do?

Public (No Auth Required) — 27 Tools

Capability	Example Tool
Discover brands	rsnc_agent_list_brands, rsnc_agent_check_brand, rsnc_agent_brand_rankings
Browse perks	rsnc_agent_browse_perks
View leaderboards	rsnc_agent_leaderboard
Network analytics	rsnc_agent_network_analytics, rsnc_agent_brand_analytics, rsnc_agent_brand_health
Compare brands	rsnc_agent_compare_brands, rsnc_agent_compare_cashback
Route purchases	rsnc_agent_route_purchase
Find best deals	rsnc_agent_best_deals
Estimate ROI	rsnc_agent_estimate_roi
Perk intelligence	rsnc_agent_perk_intelligence, rsnc_agent_perk_audience, rsnc_agent_brand_audience
Network intelligence	rsnc_agent_network_flows, rsnc_agent_network_trending
AI suggestions	rsnc_agent_suggest_events, rsnc_agent_suggest_perks

Authenticated (Agent Key Required) — 18 Tools

Capability	Example Tool
Check user balances	rsnc_agent_user_balance, rsnc_agent_user_portfolio
Process rewards	rsnc_agent_process_event, rsnc_agent_process_bulk
Redeem perks	rsnc_agent_redeem_perk
Stack deals	rsnc_agent_stack_deals
Next goal nudges	rsnc_agent_next_goal
Onboard brands	rsnc_agent_onboard_brand
Manage events & perks	rsnc_agent_create_event, rsnc_agent_create_perk
Agent rewards	rsnc_agent_my_rewards, rsnc_agent_claim_reward
User intelligence	rsnc_agent_user_persona, rsnc_agent_user_recommendations
Natural language	POST /converse (pro/enterprise tier)

45 Tools, 4 Resources, 6 Prompts

• 45 tools across 17 modules — discovery, brand, user, reward, perks, leaderboard, growth, onboarding, analytics, management, agent rewards, comparison, commerce routing, recommendations, intelligence, network intelligence, suggestions
• 4 resources — network config, brands guide, capabilities, pricing
• 6 prompts — analyze_brand, explore_category, user_activity, setup_brand, network_overview, compare_brands

Tools Reference | REST API | CLI | Authentication

Architecture

AI Assistant / Agent / Script / CLI
    |
    |--- MCP (POST /mcp)          → Streamable HTTP for AI tool calling
    |--- REST (GET/POST /api/v1)  → Standard HTTP for any language
    |--- CLI (rsnc <command>)     → Terminal & scripting via REST
    |--- A2A (POST /tasks/send)   → Agent-to-Agent protocol
    |--- Converse (POST /converse)→ Natural language queries
    |
    v
Reward Agent (Cloudflare Worker)
    | HMAC / RFC 9421 / OAuth auth, rate limiting, KV caching
    v
Resonance Backend
    |--- Event Handler (api.rsnc.network)
    |--- Shared Services (services.rsnc.network)
    |--- Supabase (agent keys, analytics RPC)
    |--- Workers AI (intelligence, suggestions, converse)
    v
Soneium Blockchain (wallet creation, RSNC distribution)

Protocol Support

• MCP — Model Context Protocol for AI tool calling
• REST — Standard HTTP API at /api/v1/* for any language or platform
• ERC-8004 — Registered server discovery at /registration.json
• A2A — Agent-to-Agent protocol at /.well-known/a2a/agent-card
• UCP — Universal Commerce Protocol at /.well-known/ucp

Routes

Method	Path	Purpose
POST	/mcp	MCP tool calls
GET	/mcp	SSE stream for notifications
DELETE	/mcp	Session termination
GET/POST/PATCH	/api/v1/*	REST API (45 endpoints)
POST	/converse	Natural language queries
POST	/tasks/send	A2A task execution
GET	/tasks/{id}	A2A task retrieval
GET	/.well-known/a2a/agent-card	A2A AgentCard (signed)
GET	/.well-known/ucp	UCP capability discovery
GET	/.well-known/jwks	Ed25519 public keys (JWKS)
GET	/.well-known/agent.json	Static MCP AgentCard
GET	/registration.json	ERC-8004 server registration
GET	/health	Health check

Authentication

Three auth methods can be combined:

Method	Purpose	Use When
HMAC-SHA256	Agent/brand identity	Direct API access, loyalty operations
RFC 9421 Ed25519	Payment network identity	Visa TAP, Mastercard Agent Pay
OAuth 2.0 Bearer	User identity	User-linked operations (balance, rewards)

See Authentication | OAuth | RFC 9421

Rate Limits

Type	Limit
Public (unauthenticated)	100 requests/minute per IP
Authenticated	20 requests/minute per agent key (configurable)

Next Steps

1. Getting Started — Connect your AI assistant
2. Tools Reference — All 45 tools documented
3. REST API — Standard HTTP endpoints for any language
4. CLI Reference — Terminal access via rsnc commands
5. Converse — Natural language queries
6. Authentication — HMAC signing and API keys
7. A2A Protocol — Agent-to-Agent integration
8. ACP Sidecar — Agentic commerce integration
9. Examples — Real conversation examples