Skip to main content

MCP Tools Reference

All 24 tools available in the Resonance MCP server (v1.1.0).

Program Design​

resonance_design_program​

Design a complete loyalty program based on community type.

Parameters:

  • communityType (required): Type of community (gaming, developer, ecommerce, creator, etc.)
  • goals (optional): Specific goals for the program
  • budget (optional): Monthly RSNC budget

Returns: Complete program design with events, rewards, and implementation code.

Event Management​

resonance_create_event​

Create a new event type.

Parameters:

  • name (required): Event name
  • rewardAmount (required): RSNC reward
  • cooldownHours (optional): Hours between claims
  • maxClaims (optional): Max claims per user

resonance_create_events_batch​

Create multiple events at once.

Parameters:

  • events (required): Array of event configurations
  • brandId (required): Your brand ID

Returns: Created events with IDs and configurations.

resonance_track_event​

Track an event and distribute rewards.

Parameters:

  • eventType (required): Event type ID
  • userEmail (required): User identifier
  • metadata (optional): Additional event data

Returns: Reward amount, transaction hash, new balance.

resonance_get_event_config​

Get all active event configurations for a brand.

Returns: Array of event configurations with types, rewards, cooldowns, and limits.

resonance_bulk_events​

Submit multiple events in a single request.

Parameters:

  • events (required): Array of events to process

Returns: Batch processing results.

resonance_admin_reward​

Manually reward users (admin/moderator triggered).

Parameters:

  • userEmail (required): User to reward
  • amount (required): RSNC amount
  • reason (optional): Reason for reward

Returns: Transaction confirmation and new balance.

User Identity​

resonance_resolve_user​

Convert any platform identity to a Resonance wallet address.

Parameters:

  • userId (required): Platform user identifier (e.g., Discord ID, email)
  • platform (optional): Platform type

Returns: Wallet address and user status.

resonance_get_user_balance​

Get a user's RSNC balance.

Parameters:

  • userEmail (required): User identifier

Returns: Balance in RSNC, wallet address.

resonance_check_eligibility​

Check if a user is eligible for a specific event reward.

Parameters:

  • userEmail (required): User identifier
  • eventType (required): Event to check

Returns: Eligibility status, cooldown remaining, claims used.

resonance_get_user_stats​

Get comprehensive user statistics.

Parameters:

  • userEmail (required): User identifier

Returns: Balance, activity history, streaks, achievements.

Engagement & Streaks​

resonance_streak_checkin​

Record a daily streak check-in.

Parameters:

  • userEmail (required): User identifier

Returns: Current streak, multiplier, milestone progress.

resonance_get_streak_status​

Get a user's current streak information.

Parameters:

  • userEmail (required): User identifier

Returns: Current streak, longest streak, multiplier, next milestone.

resonance_claim_streak_milestone​

Claim a streak milestone bonus (7, 30, 100, 365 days).

Parameters:

  • userEmail (required): User identifier
  • milestone (required): Milestone to claim

Returns: Reward amount, milestone confirmation.

resonance_log_activity​

Track user activity (voice time, messages, reactions).

Parameters:

  • userEmail (required): User identifier
  • activityType (required): Type of activity
  • value (optional): Activity value

resonance_calculate_reward​

Calculate reward amount with role multipliers applied.

Parameters:

  • baseAmount (required): Base RSNC reward
  • userEmail (required): User to calculate for

Returns: Final reward amount after multipliers.

resonance_get_leaderboard​

Get leaderboard ranked by metric.

Parameters:

  • metric (required): rsnc_earned, activity_score, claims_count, or streak_current
  • period (optional): daily, weekly, monthly, or all_time
  • limit (optional): Number of results (default: 10)

Returns: Ranked user list with scores.

resonance_update_leaderboard_stats​

Update a user's leaderboard statistics.

Parameters:

  • userEmail (required): User identifier
  • stats (required): Stats to update

Drops​

resonance_create_drop​

Create a time-limited reward drop.

Parameters:

  • eventId (required): Event to trigger
  • type (required): button or reaction
  • maxClaims (optional): Total claim limit
  • expiresIn (optional): Expiration time

Returns: Drop ID, claim URL/code.

resonance_claim_drop​

Process a drop claim for a user.

Parameters:

  • dropId (required): Drop to claim
  • userEmail (required): User claiming

Returns: Claim confirmation, reward amount.

Third-Party Integrations​

resonance_process_third_party_event​

Process events from third-party bots (Mee6, Arcane, Tatsu).

Parameters:

  • source (required): Bot source (mee6, arcane, tatsu)
  • eventData (required): Event payload from the bot

Returns: Processing result, reward if applicable.

Perks​

resonance_list_perks​

List all available perks for a brand.

Returns: Array of perks with prices and availability.

resonance_check_perk_eligibility​

Check if a user can redeem a specific perk.

Parameters:

  • userEmail (required): User identifier
  • perkId (required): Perk to check

Returns: Eligibility status, balance vs. cost.

resonance_redeem_perk​

Redeem a perk for a user.

Parameters:

  • userEmail (required): User identifier
  • perkId (required): Perk to redeem

Returns: Redemption confirmation, new balance.

Achievements​

resonance_get_user_achievements​

Get a user's achievement progress.

Parameters:

  • userEmail (required): User identifier

Returns: Unlocked achievements, progress toward next.

resonance_update_achievement_progress​

Update a user's progress toward an achievement.

Parameters:

  • userEmail (required): User identifier
  • achievementId (required): Achievement to update
  • progress (required): Progress value

Transactions​

resonance_relay_transaction​

Execute a gasless blockchain transaction via the gas relayer.

Parameters:

  • transaction (required): Transaction details

Returns: Transaction hash, status.

Webhooks​

resonance_validate_webhook​

Validate an incoming webhook signature.

Parameters:

  • payload (required): Webhook body
  • signature (required): Signature to validate

Returns: Validation result.

resonance_webhook_example​

Generate webhook receiver code.

Parameters:

  • language (required): Target language (javascript, python, go)
  • events (optional): Events to handle

Returns: Ready-to-use webhook handler code.

Diagnostics​

resonance_health_check​

Check health status of Resonance APIs.

Returns: Status of Event Handler, Shared Services, Gas Relayer, and Pregeneration endpoints.

Last updated on