Find shopping deals, earn cashback, and redeem rewards across retail, dining, and travel brands.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
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.
Maximum deals to return. Defaults to 10.
Optional max perk cost to consider.
Optional user ID (email/wallet). When provided, results include personalized data: current balance, affordable perks, and "you can afford this NOW" flags.
Direct category filter (retail, dining, travel, gaming). If provided, overrides intent-based category matching.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum deals to return. Defaults to 10. |
| budget | number | Optional max perk cost to consider. |
| intent* | 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. |
| 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. |
{
"type": "object",
"required": [
"intent"
],
"properties": {
"limit": {
"type": "number",
"description": "Maximum deals to return. Defaults to 10."
},
"budget": {
"type": "number",
"description": "Optional max perk cost to consider."
},
"intent": {
"type": "string",
"description": "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."
},
"userId": {
"type": "string",
"description": "Optional user ID (email/wallet). When provided, results include personalized data: current balance, affordable perks, and \"you can afford this NOW\" flags."
},
"category": {
"type": "string",
"description": "Direct category filter (retail, dining, travel, gaming). If provided, overrides intent-based category matching."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| period | string | Time period for analytics. Defaults to "30d". |
| brandId* | string | The brand identifier. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"period": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Time period for analytics. Defaults to \"30d\"."
},
"brandId": {
"type": "string",
"description": "The brand identifier."
}
}
}Get a brand's user persona distribution: archetype breakdown, engagement levels, platform split, and archetype drift over time.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier."
}
}
}Get a program health assessment for a brand with data-driven recommendations. Analyzes event performance, perk utilization, and customer engagement to suggest optimizations.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier. Use rsnc_agent_list_brands to discover brands by category. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier. Use rsnc_agent_list_brands to discover brands by category."
}
}
}Browse a brand's available rewards — discounts, free products, exclusive access, experiences, and more. See what's redeemable and what each costs.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier. Use rsnc_agent_list_brands to discover brands by category. |
| category | string | Optional category filter for perks. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier. Use rsnc_agent_list_brands to discover brands by category."
},
"category": {
"type": "string",
"description": "Optional category filter for perks."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of brands to rank. Defaults to 10, max 10. |
| category | string | Filter by category (e.g. "retail", "dining", "travel", "gaming"). |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "number",
"description": "Number of brands to rank. Defaults to 10, max 10."
},
"category": {
"type": "string",
"description": "Filter by category (e.g. \"retail\", \"dining\", \"travel\", \"gaming\")."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| 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. |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "number",
"description": "Maximum number of perks to return. Defaults to 20."
},
"brandId": {
"type": "string",
"description": "Scope to a specific brand. If omitted, returns deals from all active brands. Use rsnc_agent_list_brands to find brands."
},
"category": {
"type": "string",
"description": "Filter perks by category."
},
"maxPrice": {
"type": "number",
"description": "Maximum reward cost to include in results."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| query* | string | Brand name, domain, or URL to look up (e.g. "nike.com", "Starbucks"). |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Brand name, domain, or URL to look up (e.g. \"nike.com\", \"Starbucks\")."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| rewardType* | string | Type of action to claim reward for. |
| brandAddress* | string | The brand address associated with this action. |
{
"type": "object",
"required": [
"rewardType",
"brandAddress"
],
"properties": {
"rewardType": {
"enum": [
"discovery",
"onboarding"
],
"type": "string",
"description": "Type of action to claim reward for."
},
"brandAddress": {
"type": "string",
"description": "The brand address associated with this action."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| period | string | Time period for comparison. Defaults to "30d". |
| brandIds* | array | Array of 2-5 brand identifiers to compare. |
{
"type": "object",
"required": [
"brandIds"
],
"properties": {
"period": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Time period for comparison. Defaults to \"30d\"."
},
"brandIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5,
"minItems": 2,
"description": "Array of 2-5 brand identifiers to compare."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| 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). |
| purchaseAmount* | number | Purchase amount in USD to calculate exact cashback. |
{
"type": "object",
"required": [
"purchaseAmount"
],
"properties": {
"brandIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 2,
"description": "Brands to compare. Or omit and use category to auto-discover."
},
"category": {
"type": "string",
"description": "Category to auto-discover brands for comparison (retail, dining, travel, gaming)."
},
"purchaseAmount": {
"type": "number",
"description": "Purchase amount in USD to calculate exact cashback."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier (wallet address). |
| eventType* | string | The type of user action that triggers this reward event. |
| 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. |
| rewardAmount* | number | RSNC tokens awarded per claim. Must be greater than 0. |
| cooldownHours | number | Hours between claims per user. Defaults to 24. |
| detectionMethod | string | How the event is detected. Defaults to "webhook". |
{
"type": "object",
"required": [
"brandId",
"eventType",
"rewardAmount"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier (wallet address)."
},
"eventType": {
"enum": [
"purchase",
"signup",
"review",
"referral",
"custom"
],
"type": "string",
"description": "The type of user action that triggers this reward event."
},
"maxClaims": {
"type": "number",
"description": "Maximum total claims allowed. 0 = unlimited. Defaults to 0."
},
"customName": {
"type": "string",
"description": "Required when eventType is \"custom\". Human-readable name for the custom event."
},
"rewardAmount": {
"type": "number",
"description": "RSNC tokens awarded per claim. Must be greater than 0."
},
"cooldownHours": {
"type": "number",
"description": "Hours between claims per user. Defaults to 24."
},
"detectionMethod": {
"enum": [
"webhook",
"form_submission",
"api_webhook"
],
"type": "string",
"description": "How the event is detected. Defaults to \"webhook\"."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Display name for the perk. |
| tags | array | Optional tags for search and filtering. |
| brandId* | string | The brand identifier (wallet address). |
| category | string | Optional perk category (e.g. "discount", "freebie", "vip"). |
| maxSupply* | number | Total supply available. Must be greater than 0. |
| maxPerUser | number | Maximum redemptions per user. Defaults to 1. |
| description* | string | Description of what the user receives. |
| priceInPoints* | number | RSNC cost to redeem this perk. Must be greater than 0. |
{
"type": "object",
"required": [
"brandId",
"name",
"description",
"priceInPoints",
"maxSupply"
],
"properties": {
"name": {
"type": "string",
"description": "Display name for the perk."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional tags for search and filtering."
},
"brandId": {
"type": "string",
"description": "The brand identifier (wallet address)."
},
"category": {
"type": "string",
"description": "Optional perk category (e.g. \"discount\", \"freebie\", \"vip\")."
},
"maxSupply": {
"type": "number",
"description": "Total supply available. Must be greater than 0."
},
"maxPerUser": {
"type": "number",
"description": "Maximum redemptions per user. Defaults to 1."
},
"description": {
"type": "string",
"description": "Description of what the user receives."
},
"priceInPoints": {
"type": "number",
"description": "RSNC cost to redeem this perk. Must be greater than 0."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| industry* | 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. |
{
"type": "object",
"required": [
"industry"
],
"properties": {
"industry": {
"enum": [
"retail",
"dining",
"travel",
"gaming",
"other"
],
"type": "string",
"description": "Business industry category."
},
"monthlyCustomers": {
"type": "number",
"description": "Estimated monthly customers. Used to project reward costs and impact."
},
"averageOrderValue": {
"type": "number",
"description": "Average transaction value in USD. Used to estimate cashback costs."
}
}
}See how each reward event is performing at a brand: which actions drive the most engagement, claim rates, and reward efficiency per event type.
| Argument | Type | Description |
|---|---|---|
| period | string | Time period for analytics. Defaults to "30d". |
| brandId* | string | The brand identifier. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"period": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Time period for analytics. Defaults to \"30d\"."
},
"brandId": {
"type": "string",
"description": "The brand identifier."
}
}
}See top earners and most active customers for a brand. Useful for social proof or finding the most rewarding brands to shop at.
| Argument | Type | Description |
|---|---|---|
| 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. |
| brandId* | string | The brand identifier. Use rsnc_agent_list_brands to discover brands by category. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"limit": {
"type": "number",
"description": "Maximum number of entries to return. Defaults to 10."
},
"metric": {
"enum": [
"rsnc_earned",
"streak",
"activity"
],
"type": "string",
"description": "Leaderboard ranking metric. Defaults to rsnc_earned."
},
"period": {
"enum": [
"daily",
"weekly",
"monthly",
"all_time"
],
"type": "string",
"description": "Time period for the leaderboard. Defaults to all_time."
},
"brandId": {
"type": "string",
"description": "The brand identifier. Use rsnc_agent_list_brands to discover brands by category."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| 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"). |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "number",
"description": "Maximum number of brands to return. Defaults to 50."
},
"offset": {
"type": "number",
"description": "Pagination offset. Defaults to 0."
},
"category": {
"type": "string",
"description": "Filter brands by category (e.g. \"retail\", \"gaming\")."
}
}
}Manage API keys for brands you onboarded. Rotate, revoke, or check status. Never exposes secrets — credentials are accessed through the partner portal.
| Argument | Type | Description |
|---|---|---|
| action* | string | Key management action. |
| brandId* | string | Brand wallet address. |
{
"type": "object",
"required": [
"action",
"brandId"
],
"properties": {
"action": {
"enum": [
"rotate",
"revoke",
"status"
],
"type": "string",
"description": "Key management action."
},
"brandId": {
"type": "string",
"description": "Brand wallet address."
}
}
}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 arguments.
{
"type": "object",
"required": [],
"properties": {}
}Get real-time network analytics: total users, brands, rewards distributed, trending categories, and growth metrics across the entire Resonance network.
| Argument | Type | Description |
|---|---|---|
| period | string | Time period for analytics. Defaults to "30d". |
{
"type": "object",
"required": [],
"properties": {
"period": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Time period for analytics. Defaults to \"30d\"."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| period | string | Time period for flow analysis. Defaults to "30d". |
{
"type": "object",
"required": [],
"properties": {
"period": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Time period for flow analysis. Defaults to \"30d\"."
}
}
}Returns info about the Resonance rewards network — a cross-brand cashback and perks marketplace covering retail, dining, travel, gaming, and more.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Returns how many brands, users, and rewards are active — useful for understanding the scope of available deals and cashback offers.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}See what's trending across the Resonance network: hottest perk categories, fastest growing brand categories, and overall network health metrics.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum number of trending items per category. Defaults to 10. |
| period | string | Time period for trending data. Defaults to "7d". |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "number",
"description": "Maximum number of trending items per category. Defaults to 10."
},
"period": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Time period for trending data. Defaults to \"7d\"."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| userId* | 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. |
{
"type": "object",
"required": [
"userId"
],
"properties": {
"userId": {
"type": "string",
"description": "User identifier (email or wallet address)."
},
"brandId": {
"type": "string",
"description": "Optional: focus on a specific brand. If omitted, finds the best goal across all brands the user is active with."
},
"targetPerkId": {
"type": "string",
"description": "Optional: calculate path to a specific perk. If omitted, finds the most attainable perk."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| website | string | Brand website URL. |
| category | string | Industry category (retail, dining, travel, gaming, other). |
| description | string | Short description of the business. |
| brandAddress* | string | Brand's public wallet address (Ethereum format, 0x-prefixed). |
| businessName* | string | Brand/business name. |
| contactEmail* | string | Contact email — becomes their portal login. |
{
"type": "object",
"required": [
"brandAddress",
"businessName",
"contactEmail"
],
"properties": {
"website": {
"type": "string",
"description": "Brand website URL."
},
"category": {
"type": "string",
"description": "Industry category (retail, dining, travel, gaming, other)."
},
"description": {
"type": "string",
"description": "Short description of the business."
},
"brandAddress": {
"type": "string",
"description": "Brand's public wallet address (Ethereum format, 0x-prefixed)."
},
"businessName": {
"type": "string",
"description": "Brand/business name."
},
"contactEmail": {
"type": "string",
"description": "Contact email — becomes their portal login."
}
}
}Analyze perk collection performance: redemption rates, supply status, which perks are most popular. Helps brands optimize their reward catalog.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier."
}
}
}Get the persona breakdown of users who claimed a specific perk: archetypes, engagement levels, and platform distribution.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier. |
| collectionId* | number | The perk collection ID. |
{
"type": "object",
"required": [
"brandId",
"collectionId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier."
},
"collectionId": {
"type": "number",
"description": "The perk collection ID."
}
}
}Get intelligence on a brand's perks: heat scores, conversion funnels, supply depletion rates, and retention impact. Helps optimize perk catalogs.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier."
}
}
}Record multiple qualifying actions in one request — batch purchases, signups, or engagement events across brands. Requires authentication.
| Argument | Type | Description |
|---|---|---|
| events* | array | Array of events to process. |
{
"type": "object",
"required": [
"events"
],
"properties": {
"events": {
"type": "array",
"items": {
"type": "object",
"required": [
"brandId",
"eventType",
"userId"
],
"properties": {
"userId": {
"type": "string",
"description": "User email address."
},
"brandId": {
"type": "string",
"description": "The brand identifier. Use rsnc_agent_list_brands to discover brands by category."
},
"metadata": {
"type": "object",
"description": "Optional metadata to attach to the event."
},
"eventType": {
"type": "string",
"description": "The type of event to track."
}
}
},
"description": "Array of events to process."
}
}
}Record a qualifying action (purchase, signup, review, referral) to earn cashback for a user. Returns the reward amount credited. Requires authentication.
| Argument | Type | Description |
|---|---|---|
| userId* | string | User email address. |
| brandId* | string | The brand identifier. Use rsnc_agent_list_brands to discover brands by category. |
| metadata | object | Optional metadata to attach to the event. |
| eventType* | string | The type of event to track (e.g. "purchase", "review", "referral"). |
{
"type": "object",
"required": [
"brandId",
"eventType",
"userId"
],
"properties": {
"userId": {
"type": "string",
"description": "User email address."
},
"brandId": {
"type": "string",
"description": "The brand identifier. Use rsnc_agent_list_brands to discover brands by category."
},
"metadata": {
"type": "object",
"description": "Optional metadata to attach to the event."
},
"eventType": {
"type": "string",
"description": "The type of event to track (e.g. \"purchase\", \"review\", \"referral\")."
}
}
}Claim a reward for a user — redeem a discount, freebie, or exclusive offer using their earned cashback. Returns a confirmation code. Requires authentication.
| Argument | Type | Description |
|---|---|---|
| perkId* | string | The ID of the perk to redeem. |
| userId* | string | User identifier (email or wallet address). |
| brandId* | string | The brand identifier. Use rsnc_agent_list_brands to discover brands by category. |
{
"type": "object",
"required": [
"perkId",
"userId",
"brandId"
],
"properties": {
"perkId": {
"type": "string",
"description": "The ID of the perk to redeem."
},
"userId": {
"type": "string",
"description": "User identifier (email or wallet address)."
},
"brandId": {
"type": "string",
"description": "The brand identifier. Use rsnc_agent_list_brands to discover brands by category."
}
}
}Request information about adding a Resonance cashback program to a business. Captures contact details for the partnerships team.
| Argument | Type | Description |
|---|---|---|
| website | string | Business website URL. |
| industry | string | Business industry category. |
| businessName* | string | Name of the business. |
| contactEmail* | string | Contact email for the business owner or decision maker. |
{
"type": "object",
"required": [
"businessName",
"contactEmail"
],
"properties": {
"website": {
"type": "string",
"description": "Business website URL."
},
"industry": {
"type": "string",
"description": "Business industry category."
},
"businessName": {
"type": "string",
"description": "Name of the business."
},
"contactEmail": {
"type": "string",
"description": "Contact email for the business owner or decision maker."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| intent* | 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. |
{
"type": "object",
"required": [
"intent"
],
"properties": {
"intent": {
"type": "string",
"description": "What the user wants to buy — e.g. \"running shoes\", \"coffee\", \"hotel in NYC\"."
},
"userId": {
"type": "string",
"description": "Optional user ID for personalized routing — factors in existing balances and redeemable perks."
},
"category": {
"type": "string",
"description": "Direct category filter (retail, dining, travel, gaming)."
},
"purchaseAmount": {
"type": "number",
"description": "Expected purchase amount in USD. Used to calculate exact cashback and savings."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| userId* | string | User ID to check redeemable perks against their balance. |
| brandId* | string | The brand to optimize the deal for. |
| purchaseAmount* | number | Purchase amount in USD. |
{
"type": "object",
"required": [
"brandId",
"purchaseAmount",
"userId"
],
"properties": {
"userId": {
"type": "string",
"description": "User ID to check redeemable perks against their balance."
},
"brandId": {
"type": "string",
"description": "The brand to optimize the deal for."
},
"purchaseAmount": {
"type": "number",
"description": "Purchase amount in USD."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier."
}
}
}Get AI-recommended perk configurations for a brand. Suggests perk types, pricing, and supply limits based on audience composition and balance distribution patterns.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier."
}
}
}Update an existing reward event's configuration. Changes to reward amounts are validated against performance data to ensure sufficient data for evaluation.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier (wallet address). |
| enabled | boolean | Enable or disable the event. |
| eventId* | string | The event identifier to update. |
| 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. |
{
"type": "object",
"required": [
"brandId",
"eventId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier (wallet address)."
},
"enabled": {
"type": "boolean",
"description": "Enable or disable the event."
},
"eventId": {
"type": "string",
"description": "The event identifier to update."
},
"maxClaims": {
"type": "number",
"description": "New maximum total claims allowed. 0 = unlimited."
},
"rewardAmount": {
"type": "number",
"description": "New RSNC tokens awarded per claim."
},
"cooldownHours": {
"type": "number",
"description": "New cooldown period in hours between claims per user."
}
}
}Update a perk collection's configuration. Can adjust pricing, supply, and active status.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | The brand identifier (wallet address). Used for permission and scope checks. |
| isActive | boolean | Enable or disable the perk. |
| maxSupply | number | New total supply. |
| description | string | New description text. |
| collectionId* | number | The perk collection ID to update. |
| priceInPoints | number | New RSNC cost to redeem. |
{
"type": "object",
"required": [
"brandId",
"collectionId"
],
"properties": {
"brandId": {
"type": "string",
"description": "The brand identifier (wallet address). Used for permission and scope checks."
},
"isActive": {
"type": "boolean",
"description": "Enable or disable the perk."
},
"maxSupply": {
"type": "number",
"description": "New total supply."
},
"description": {
"type": "string",
"description": "New description text."
},
"collectionId": {
"type": "number",
"description": "The perk collection ID to update."
},
"priceInPoints": {
"type": "number",
"description": "New RSNC cost to redeem."
}
}
}Check how much cashback a user has earned at a specific brand and how much they can spend on rewards. Requires authentication.
| Argument | Type | Description |
|---|---|---|
| userId* | string | User identifier (email address or wallet address). |
| brandId* | string | The brand identifier. Use rsnc_agent_list_brands to discover brands by category. |
{
"type": "object",
"required": [
"userId",
"brandId"
],
"properties": {
"userId": {
"type": "string",
"description": "User identifier (email address or wallet address)."
},
"brandId": {
"type": "string",
"description": "The brand identifier. Use rsnc_agent_list_brands to discover brands by category."
}
}
}Get a user's behavioral profile: earn patterns, persona archetype, tag/brand affinities, price preferences, and network position. Requires HMAC authentication.
| Argument | Type | Description |
|---|---|---|
| userId* | string | The user identifier (email or wallet address). |
{
"type": "object",
"required": [
"userId"
],
"properties": {
"userId": {
"type": "string",
"description": "The user identifier (email or wallet address)."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| userId* | string | User identifier (email address or wallet address). |
{
"type": "object",
"required": [
"userId"
],
"properties": {
"userId": {
"type": "string",
"description": "User identifier (email address or wallet address)."
}
}
}Get personalized perk recommendations for a user, scored by persona affinity and affordability. Requires HMAC authentication.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum number of recommendations to return. Defaults to 5. |
| userId* | string | The user identifier (email or wallet address). |
{
"type": "object",
"required": [
"userId"
],
"properties": {
"limit": {
"type": "number",
"description": "Maximum number of recommendations to return. Defaults to 5."
},
"userId": {
"type": "string",
"description": "The user identifier (email or wallet address)."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| userId* | string | User identifier (email address or wallet address). |
| brandId* | string | The brand identifier. Use rsnc_agent_list_brands to discover brands by category. |
{
"type": "object",
"required": [
"userId",
"brandId"
],
"properties": {
"userId": {
"type": "string",
"description": "User identifier (email address or wallet address)."
},
"brandId": {
"type": "string",
"description": "The brand identifier. Use rsnc_agent_list_brands to discover brands by category."
}
}
}