Skip to main content

MCP Resources Reference

Resources provide read-only access to Resonance configuration, documentation, and reference data.

Contract Resources​

resonance://contracts​

Smart contract addresses for the current network.

{
  "network": "mainnet",
  "chainId": 1868,
  "contracts": {
    "ResonanceToken": "0x4183CD8fE04bA0f10Ca83cf9E76e58ef8dB7cb33",
    "PerkNFT": "0x997f05E7447Fdde75d47eBb12D4D6C65013AA0Da",
    "PointsSale": "0x02939031C36637a4c46d86832D7015a2F350cc7D"
  }
}

resonance://contracts/all​

Full contract data including ABIs and supported methods.

resonance://network​

Network configuration for the current environment (chain ID, RPC URL, block explorer, native currency).

Event Resources​

resonance://event-types​

Standard event types with recommended configurations, including channel constraints and reward ranges.

{
  "standard_events": [
    {
      "type": "daily_checkin",
      "description": "Daily check-in reward",
      "recommended_reward": 10,
      "recommended_cooldown": 24
    }
  ]
}

Error Resources​

resonance://errors/*​

HTTP status codes and error handling patterns, organized by error category.

{
  "COOLDOWN_ACTIVE": {
    "code": 429,
    "message": "User is on cooldown for this event",
    "resolution": "Wait for cooldown to expire"
  },
  "INSUFFICIENT_BALANCE": {
    "code": 400,
    "message": "Brand has insufficient RSNC balance",
    "resolution": "Add funds in Partner Portal"
  }
}

Shared Services Resources​

resonance://shared-services/*​

API endpoint documentation for shared services (streaks, leaderboards, achievements, perks, community management).

OAuth Resources​

resonance://oauth/*​

OAuth provider ID formats for all supported platforms (Discord, Twitter, GitHub, Google, Telegram, Spotify, Instagram, TikTok).

Rate Limit Resources​

resonance://rate-limits/*​

Rate limiting strategies by endpoint, including per-user and per-brand limits.

SDK Resources​

resonance://sdk/*​

JavaScript SDK method documentation with examples for event tracking, user management, and integration patterns.

Webhook Resources​

resonance://webhooks/*​

Webhook event types, payload formats, and signature validation patterns.

Documentation Resources​

resonance://docs/*​

Full documentation content (50+ pages), lazy-loaded and cached. Available topics include:

  • resonance://docs/discord — Discord integration guide
  • resonance://docs/telegram — Telegram integration guide
  • resonance://docs/api — API reference
  • resonance://docs/sdk — SDK documentation
  • resonance://docs/shopify — Shopify integration
  • resonance://docs/guides/* — Various how-to guides

Using Resources​

Resources are accessed automatically by the AI when relevant. You can also request them explicitly:

"Show me the Resonance contract addresses"

"What are the recommended event types for a gaming community?"

"What does error code COOLDOWN_ACTIVE mean?"

"Show me the SDK methods for tracking events"

The AI will query the appropriate resource and present the information.

Last updated on