Resonance Reward Agent

Official45 tools

by rsnc

Find shopping deals, earn cashback, and redeem rewards across retail, dining, and travel brands.

Find shopping deals, earn cashback, and redeem rewards across retail, dining, and travel.

Captured live from the server via tools/list.

rsnc_agent_network_info

Returns info about the Resonance rewards network — a cross-brand cashback and perks marketplace covering retail, dining, travel, gaming, and more.

No parameters.

rsnc_agent_list_brands

Search and browse brands offering cashback, rewards, and deals. Filter by category (retail, dining, travel, gaming) to find relevant offers for shopping, booking, or purchasing.

Parameters (3)

categorystring
Filter brands by category (e.g. "retail", "gaming").
limitnumber
Maximum number of brands to return. Defaults to 50.
offsetnumber
Pagination offset. Defaults to 0.

rsnc_agent_network_stats

Returns how many brands, users, and rewards are active — useful for understanding the scope of available deals and cashback offers.

No parameters.

rsnc_agent_check_brand

Check if a brand or website is on the Resonance cashback network. Returns their reward program details if found, or information about how to join if not.

Parameters (1)

querystringrequired
Brand name, domain, or URL to look up (e.g. "nike.com", "Starbucks").

rsnc_agent_brand_rankings

See which brands offer the most rewards, have the most active programs, or the best cashback rates. Useful for finding where to shop for maximum value.

Parameters (2)

categorystring
Filter by category (e.g. "retail", "dining", "travel", "gaming").
limitnumber
Number of brands to rank. Defaults to 10, max 10.

rsnc_agent_brand_info

Get details on a brand's reward program: what actions earn cashback (purchases, signups, reviews, referrals), how much you earn per action, and any bonus opportunities.

Parameters (1)

brandIdstringrequired
The brand identifier. Use rsnc_agent_list_brands to discover brands by category.

rsnc_agent_brand_perks

Browse a brand's available rewards — discounts, free products, exclusive access, experiences, and more. See what's redeemable and what each costs.

Parameters (2)

brandIdstringrequired
The brand identifier. Use rsnc_agent_list_brands to discover brands by category.
categorystring
Optional category filter for perks.

rsnc_agent_user_balance

Check how much cashback a user has earned at a specific brand and how much they can spend on rewards. Requires authentication.

Parameters (2)

userIdstringrequired
User identifier (email address or wallet address).
brandIdstringrequired
The brand identifier. Use rsnc_agent_list_brands to discover brands by category.

rsnc_agent_user_stats

Get a user's complete reward profile for a brand: total earned, total redeemed, active streaks, and achievements. Useful for recommending next actions. Requires authentication.

Parameters (2)

userIdstringrequired
User identifier (email address or wallet address).
brandIdstringrequired
The brand identifier. Use rsnc_agent_list_brands to discover brands by category.

rsnc_agent_user_portfolio

Get a unified view of a user's rewards across ALL brands — total balance, per-brand breakdown, active streaks, and the best perk they can afford right now. The cross-brand loyalty dashboard. Requires authentication.

Parameters (1)

userIdstringrequired
User identifier (email address or wallet address).

rsnc_agent_process_event

Record a qualifying action (purchase, signup, review, referral) to earn cashback for a user. Returns the reward amount credited. Requires authentication.

Parameters (4)

brandIdstringrequired
The brand identifier. Use rsnc_agent_list_brands to discover brands by category.
eventTypestringrequired
The type of event to track (e.g. "purchase", "review", "referral").
userIdstringrequired
User email address.
metadataobject
Optional metadata to attach to the event.

rsnc_agent_process_bulk

Record multiple qualifying actions in one request — batch purchases, signups, or engagement events across brands. Requires authentication.

Parameters (1)

eventsarrayrequired
Array of events to process.

rsnc_agent_browse_perks

Search for deals, discounts, and rewards across all brands or filter by category and budget. Find cashback offers, free products, exclusive access, and experiences from retail, dining, travel, and more.

Parameters (4)

categorystring
Filter perks by category.
maxPricenumber
Maximum reward cost to include in results.
brandIdstring
Scope to a specific brand. If omitted, returns deals from all active brands. Use rsnc_agent_list_brands to find brands.
limitnumber
Maximum number of perks to return. Defaults to 20.

rsnc_agent_redeem_perk

Claim a reward for a user — redeem a discount, freebie, or exclusive offer using their earned cashback. Returns a confirmation code. Requires authentication.

Parameters (3)

perkIdstringrequired
The ID of the perk to redeem.
userIdstringrequired
User identifier (email or wallet address).
brandIdstringrequired
The brand identifier. Use rsnc_agent_list_brands to discover brands by category.

rsnc_agent_leaderboard

See top earners and most active customers for a brand. Useful for social proof or finding the most rewarding brands to shop at.

Parameters (4)

brandIdstringrequired
The brand identifier. Use rsnc_agent_list_brands to discover brands by category.
metricstring
Leaderboard ranking metric. Defaults to rsnc_earned.
periodstring
Time period for the leaderboard. Defaults to all_time.
limitnumber
Maximum number of entries to return. Defaults to 10.

rsnc_agent_estimate_roi

Estimate the return on investment of adding a Resonance cashback program to a business. Takes industry and business metrics to project engagement and retention impact.

Parameters (3)

industrystringrequired
Business industry category.
monthlyCustomersnumber
Estimated monthly customers. Used to project reward costs and impact.
averageOrderValuenumber
Average transaction value in USD. Used to estimate cashback costs.

rsnc_agent_request_info

Request information about adding a Resonance cashback program to a business. Captures contact details for the partnerships team.

Parameters (4)

businessNamestringrequired
Name of the business.
contactEmailstringrequired
Contact email for the business owner or decision maker.
websitestring
Business website URL.
industrystring
Business industry category.

rsnc_agent_onboard_brand

Register a new brand on the Resonance cashback network. Creates their account, generates credentials (accessible via partner portal), and sends a welcome email. Requires agent authentication with onboarding permission.

Parameters (6)

brandAddressstringrequired
Brand's public wallet address (Ethereum format, 0x-prefixed).
businessNamestringrequired
Brand/business name.
contactEmailstringrequired
Contact email — becomes their portal login.
websitestring
Brand website URL.
categorystring
Industry category (retail, dining, travel, gaming, other).
descriptionstring
Short description of the business.

rsnc_agent_manage_keys

Manage API keys for brands you onboarded. Rotate, revoke, or check status. Never exposes secrets — credentials are accessed through the partner portal.

Parameters (2)

actionstringrequired
Key management action.
brandIdstringrequired
Brand wallet address.

rsnc_agent_network_analytics

Get real-time network analytics: total users, brands, rewards distributed, trending categories, and growth metrics across the entire Resonance network.

Parameters (1)

periodstring
Time period for analytics. Defaults to "30d".

rsnc_agent_brand_analytics

Deep analytics for a specific brand: daily performance trends, customer velocity, event activity, and program health metrics. Use this to understand how a brand's reward program is performing.

Parameters (2)

brandIdstringrequired
The brand identifier.
periodstring
Time period for analytics. Defaults to "30d".

rsnc_agent_event_performance

See how each reward event is performing at a brand: which actions drive the most engagement, claim rates, and reward efficiency per event type.

Parameters (2)

brandIdstringrequired
The brand identifier.
periodstring
Time period for analytics. Defaults to "30d".

rsnc_agent_perk_analytics

Analyze perk collection performance: redemption rates, supply status, which perks are most popular. Helps brands optimize their reward catalog.

Parameters (1)

brandIdstringrequired
The brand identifier.

rsnc_agent_brand_health

Get a program health assessment for a brand with data-driven recommendations. Analyzes event performance, perk utilization, and customer engagement to suggest optimizations.

Parameters (1)

brandIdstringrequired
The brand identifier.

rsnc_agent_create_event

Create a new reward event for a brand. Events define what user actions earn cashback. The agent validates the configuration against the brand's data maturity before creating.

Parameters (7)

brandIdstringrequired
The brand identifier (wallet address).
eventTypestringrequired
The type of user action that triggers this reward event.
rewardAmountnumberrequired
RSNC tokens awarded per claim. Must be greater than 0.
maxClaimsnumber
Maximum total claims allowed. 0 = unlimited. Defaults to 0.
cooldownHoursnumber
Hours between claims per user. Defaults to 24.
customNamestring
Required when eventType is "custom". Human-readable name for the custom event.
detectionMethodstring
How the event is detected. Defaults to "webhook".

rsnc_agent_update_event

Update an existing reward event's configuration. Changes to reward amounts are validated against performance data to ensure sufficient data for evaluation.

Parameters (6)

brandIdstringrequired
The brand identifier (wallet address).
eventIdstringrequired
The event identifier to update.
rewardAmountnumber
New RSNC tokens awarded per claim.
maxClaimsnumber
New maximum total claims allowed. 0 = unlimited.
cooldownHoursnumber
New cooldown period in hours between claims per user.
enabledboolean
Enable or disable the event.

rsnc_agent_create_perk

Create a new perk collection for a brand. Perks are rewards users can claim with earned RSNC tokens — discounts, free products, VIP access, and more.

Parameters (8)

brandIdstringrequired
The brand identifier (wallet address).
namestringrequired
Display name for the perk.
descriptionstringrequired
Description of what the user receives.
priceInPointsnumberrequired
RSNC cost to redeem this perk. Must be greater than 0.
maxSupplynumberrequired
Total supply available. Must be greater than 0.
maxPerUsernumber
Maximum redemptions per user. Defaults to 1.
categorystring
Optional perk category (e.g. "discount", "freebie", "vip").
tagsarray
Optional tags for search and filtering.

rsnc_agent_update_perk

Update a perk collection's configuration. Can adjust pricing, supply, and active status.

Parameters (6)

brandIdstringrequired
The brand identifier (wallet address). Used for permission and scope checks.
collectionIdnumberrequired
The perk collection ID to update.
priceInPointsnumber
New RSNC cost to redeem.
maxSupplynumber
New total supply.
isActiveboolean
Enable or disable the perk.
descriptionstring
New description text.

rsnc_agent_my_rewards

Check your agent's RSNC reward earnings, activity stats, and remaining rate cap allowances. Shows how much the agent has earned for discovering brands, onboarding partners, and driving network growth.

No parameters.

rsnc_agent_claim_reward

Claim a reward for a valuable agent action. Rewards are paid from the Resonance network fund with daily and weekly rate caps. Discovery earns 100 RSNC, onboarding earns 500 RSNC.

Parameters (2)

rewardTypestringrequired
Type of action to claim reward for.
brandAddressstringrequired
The brand address associated with this action.

rsnc_agent_compare_brands

Compare 2-5 brands side-by-side across all performance metrics: velocity, customers reached, transactions, LTZ distributed, event diversity, and perk utilization. Returns a structured comparison matrix with per-metric winners and insights.

Parameters (2)

brandIdsarrayrequired
Array of 2-5 brand identifiers to compare.
periodstring
Time period for comparison. Defaults to "30d".

rsnc_agent_compare_cashback

Compare cashback rates across brands for a specific purchase amount. Shows exactly how much you earn at each brand — side-by-side "Buy $100 at Nike = $8 back vs Adidas = $3 back". The key decision tool for purchase routing.

Parameters (3)

brandIdsarray
Brands to compare. Or omit and use category to auto-discover.
categorystring
Category to auto-discover brands for comparison (retail, dining, travel, gaming).
purchaseAmountnumberrequired
Purchase amount in USD to calculate exact cashback.

rsnc_agent_best_deals

Find the best cashback deals and rewards matching a shopping intent. Searches brands by category, ranks by reward value, and optionally personalizes results based on user balances. Use this when a user wants to shop, eat, travel, or game and wants the best rewards.

Parameters (5)

intentstringrequired
What the user wants to do — e.g. "buy running shoes", "get coffee", "book a hotel", "play games". Matched against brand categories and perk descriptions.
categorystring
Direct category filter (retail, dining, travel, gaming). If provided, overrides intent-based category matching.
userIdstring
Optional user ID (email/wallet). When provided, results include personalized data: current balance, affordable perks, and "you can afford this NOW" flags.
budgetnumber
Optional max perk cost to consider.
limitnumber
Maximum deals to return. Defaults to 10.

rsnc_agent_next_goal

Calculate the fastest path to a user's next attainable reward. Shows exactly how many actions (purchases, reviews, referrals) are needed to afford a specific perk. Creates urgency and drives engagement. Requires authentication.

Parameters (3)

userIdstringrequired
User identifier (email or wallet address).
brandIdstring
Optional: focus on a specific brand. If omitted, finds the best goal across all brands the user is active with.
targetPerkIdstring
Optional: calculate path to a specific perk. If omitted, finds the most attainable perk.

rsnc_agent_route_purchase

Find the best brand to buy from based on cashback and rewards. Given a shopping intent, compares all matching brands and ranks them by total reward value — cashback earned, perks redeemable, and effective savings. The core purchase intelligence tool for agentic commerce.

Parameters (4)

intentstringrequired
What the user wants to buy — e.g. "running shoes", "coffee", "hotel in NYC".
categorystring
Direct category filter (retail, dining, travel, gaming).
purchaseAmountnumber
Expected purchase amount in USD. Used to calculate exact cashback and savings.
userIdstring
Optional user ID for personalized routing — factors in existing balances and redeemable perks.

rsnc_agent_stack_deals

Calculate the optimal deal stack for a specific purchase at a specific brand. Combines base cashback earned + best redeemable perk + any active promotions to show total savings. Use after route_purchase to maximize value at the chosen brand.

Parameters (3)

brandIdstringrequired
The brand to optimize the deal for.
purchaseAmountnumberrequired
Purchase amount in USD.
userIdstringrequired
User ID to check redeemable perks against their balance.

rsnc_agent_user_persona

Get a user's behavioral profile: earn patterns, persona archetype, tag/brand affinities, price preferences, and network position. Requires HMAC authentication.

Parameters (1)

userIdstringrequired
The user identifier (email or wallet address).

rsnc_agent_user_recommendations

Get personalized perk recommendations for a user, scored by persona affinity and affordability. Requires HMAC authentication.

Parameters (2)

userIdstringrequired
The user identifier (email or wallet address).
limitnumber
Maximum number of recommendations to return. Defaults to 5.

rsnc_agent_perk_intelligence

Get intelligence on a brand's perks: heat scores, conversion funnels, supply depletion rates, and retention impact. Helps optimize perk catalogs.

Parameters (1)

brandIdstringrequired
The brand identifier.

rsnc_agent_perk_audience

Get the persona breakdown of users who claimed a specific perk: archetypes, engagement levels, and platform distribution.

Parameters (2)

brandIdstringrequired
The brand identifier.
collectionIdnumberrequired
The perk collection ID.

rsnc_agent_brand_audience

Get a brand's user persona distribution: archetype breakdown, engagement levels, platform split, and archetype drift over time.

Parameters (1)

brandIdstringrequired
The brand identifier.

rsnc_agent_network_flows

See how users flow between brands across the network. Shows which brands are emitters (users leave to redeem elsewhere) vs attractors (users come to redeem). All data is anonymous and category-level.

Parameters (1)

periodstring
Time period for flow analysis. Defaults to "30d".

rsnc_agent_network_trending

See what's trending across the Resonance network: hottest perk categories, fastest growing brand categories, and overall network health metrics.

Parameters (2)

periodstring
Time period for trending data. Defaults to "7d".
limitnumber
Maximum number of trending items per category. Defaults to 10.

rsnc_agent_suggest_events

Get AI-recommended reward event configurations for a brand. Analyzes what event types, reward amounts, and cooldowns work best in the brand's category based on network-wide patterns.

Parameters (1)

brandIdstringrequired
The brand identifier.

rsnc_agent_suggest_perks

Get AI-recommended perk configurations for a brand. Suggests perk types, pricing, and supply limits based on audience composition and balance distribution patterns.

Parameters (1)

brandIdstringrequired
The brand identifier.

Install

Tools (45)

rsnc_agent_network_inforsnc_agent_list_brandsrsnc_agent_network_statsrsnc_agent_check_brandrsnc_agent_brand_rankingsrsnc_agent_brand_inforsnc_agent_brand_perksrsnc_agent_user_balance

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://agent.rsnc.network/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "reward-agent": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agent.rsnc.network/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.