Resonance Reward Agent

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Resonance Reward Agent": {
      "url": "https://agent.rsnc.network/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (45)

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • limit — number — Maximum number of brands to return. Defaults to 50.
  • offset — number — Pagination offset. Defaults to 0.
  • category — string — Filter brands by category (e.g. "retail", "gaming").

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• rsnc_agent_network_stats

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • query (required) — string — Brand name, domain, or URL to look up (e.g. "nike.com", "Starbucks").

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • limit — number — Number of brands to rank. Defaults to 10, max 10.
  • category — string — Filter by category (e.g. "retail", "dining", "travel", "gaming").

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier. Use rsnc_agent_list_brands to discover brands by category.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier. Use rsnc_agent_list_brands to discover brands by category.
  • category — string — Optional category filter for perks.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • userId (required) — string — User identifier (email address or wallet address).
  • brandId (required) — string — The brand identifier. Use rsnc_agent_list_brands to discover brands by category.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • userId (required) — string — User identifier (email address or wallet address).
  • brandId (required) — string — The brand identifier. Use rsnc_agent_list_brands to discover brands by category.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • userId (required) — string — User identifier (email address or wallet address).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier. Use rsnc_agent_list_brands to discover brands by category.
  • eventType (required) — string — The type of event to track (e.g. "purchase", "review", "referral").
  • userId (required) — string — User email address.
  • metadata — object — Optional metadata to attach to the event.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• rsnc_agent_process_bulk

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

  Parameters:

  • events (required) — array — Array of events to process.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • limit — number — Maximum number of perks to return. Defaults to 20.
  • brandId — string — Scope to a specific brand. If omitted, returns deals from all active brands. Use rsnc_agent_list_brands to find brands.
  • category — string — Filter perks by category.
  • maxPrice — number — Maximum reward cost to include in results.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • perkId (required) — string — The ID of the perk to redeem.
  • userId (required) — string — User identifier (email or wallet address).
  • brandId (required) — string — The brand identifier. Use rsnc_agent_list_brands to discover brands by category.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier. Use rsnc_agent_list_brands to discover brands by category.
  • limit — number — Maximum number of entries to return. Defaults to 10.
  • metric — string — Leaderboard ranking metric. Defaults to rsnc_earned.
  • period — string — Time period for the leaderboard. Defaults to all_time.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • industry (required) — string — Business industry category.
  • monthlyCustomers — number — Estimated monthly customers. Used to project reward costs and impact.
  • averageOrderValue — number — Average transaction value in USD. Used to estimate cashback costs.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• rsnc_agent_request_info

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

  Parameters:

  • businessName (required) — string — Name of the business.
  • contactEmail (required) — string — Contact email for the business owner or decision maker.
  • website — string — Business website URL.
  • industry — string — Business industry category.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandAddress (required) — string — Brand's public wallet address (Ethereum format, 0x-prefixed).
  • businessName (required) — string — Brand/business name.
  • contactEmail (required) — string — Contact email — becomes their portal login.
  • website — string — Brand website URL.
  • category — string — Industry category (retail, dining, travel, gaming, other).
  • description — string — Short description of the business.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • action (required) — string — Key management action.
  • brandId (required) — string — Brand wallet address.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • period — string — Time period for analytics. Defaults to "30d".

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier.
  • period — string — Time period for analytics. Defaults to "30d".

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier.
  • period — string — Time period for analytics. Defaults to "30d".

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• rsnc_agent_perk_analytics

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

  Parameters:

  • brandId (required) — string — The brand identifier.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier (wallet address).
  • eventType (required) — string — The type of user action that triggers this reward event.
  • rewardAmount (required) — number — RSNC tokens awarded per claim. Must be greater than 0.
  • maxClaims — number — Maximum total claims allowed. 0 = unlimited. Defaults to 0.
  • customName — string — Required when eventType is "custom". Human-readable name for the custom event.
  • cooldownHours — number — Hours between claims per user. Defaults to 24.
  • detectionMethod — string — How the event is detected. Defaults to "webhook".

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier (wallet address).
  • eventId (required) — string — The event identifier to update.
  • enabled — boolean — Enable or disable the event.
  • maxClaims — number — New maximum total claims allowed. 0 = unlimited.
  • rewardAmount — number — New RSNC tokens awarded per claim.
  • cooldownHours — number — New cooldown period in hours between claims per user.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier (wallet address).
  • name (required) — string — Display name for the perk.
  • description (required) — string — Description of what the user receives.
  • priceInPoints (required) — number — RSNC cost to redeem this perk. Must be greater than 0.
  • maxSupply (required) — number — Total supply available. Must be greater than 0.
  • tags — array — Optional tags for search and filtering.
  • category — string — Optional perk category (e.g. "discount", "freebie", "vip").
  • maxPerUser — number — Maximum redemptions per user. Defaults to 1.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• rsnc_agent_update_perk

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

  Parameters:

  • brandId (required) — string — The brand identifier (wallet address). Used for permission and scope checks.
  • collectionId (required) — number — The perk collection ID to update.
  • isActive — boolean — Enable or disable the perk.
  • maxSupply — number — New total supply.
  • description — string — New description text.
  • priceInPoints — number — New RSNC cost to redeem.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • rewardType (required) — string — Type of action to claim reward for.
  • brandAddress (required) — string — The brand address associated with this action.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandIds (required) — array — Array of 2-5 brand identifiers to compare.
  • period — string — Time period for comparison. Defaults to "30d".

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • purchaseAmount (required) — number — Purchase amount in USD to calculate exact cashback.
  • brandIds — array — Brands to compare. Or omit and use category to auto-discover.
  • category — string — Category to auto-discover brands for comparison (retail, dining, travel, gaming).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • intent (required) — string — 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.
  • limit — number — Maximum deals to return. Defaults to 10.
  • budget — number — Optional max perk cost to consider.
  • userId — string — Optional user ID (email/wallet). When provided, results include personalized data: current balance, affordable perks, and "you can afford this NOW" flags.
  • category — string — Direct category filter (retail, dining, travel, gaming). If provided, overrides intent-based category matching.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • userId (required) — string — User identifier (email or wallet address).
  • brandId — string — Optional: focus on a specific brand. If omitted, finds the best goal across all brands the user is active with.
  • targetPerkId — string — Optional: calculate path to a specific perk. If omitted, finds the most attainable perk.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand to optimize the deal for.
  • purchaseAmount (required) — number — Purchase amount in USD.
  • userId (required) — string — User ID to check redeemable perks against their balance.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • userId (required) — string — The user identifier (email or wallet address).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• rsnc_agent_user_recommendations

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

  Parameters:

  • userId (required) — string — The user identifier (email or wallet address).
  • limit — number — Maximum number of recommendations to return. Defaults to 5.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• rsnc_agent_perk_audience

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

  Parameters:

  • brandId (required) — string — The brand identifier.
  • collectionId (required) — number — The perk collection ID.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• rsnc_agent_brand_audience

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

  Parameters:

  • brandId (required) — string — The brand identifier.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • period — string — Time period for flow analysis. Defaults to "30d".

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • limit — number — Maximum number of trending items per category. Defaults to 10.
  • period — string — Time period for trending data. Defaults to "7d".

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • brandId (required) — string — The brand identifier.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.