Installing the MCP Server

Set up the Resonance MCP server to enable AI-assisted loyalty program management.

Prerequisites

• Node.js 18+ installed
• AI assistant that supports MCP (Claude Desktop, Cursor, etc.)
• Resonance Partner Portal account

Install via npm

npm install -g @resonance/mcp-server

Or use npx (no installation required):

npx @resonance/mcp-server

Configure Claude Desktop

Add to your Claude Desktop MCP configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "resonance": {
      "command": "npx",
      "args": ["@resonance/mcp-server"],
      "env": {
        "RESONANCE_NETWORK": "mainnet",
        "RESONANCE_BRAND_ID": "0xYourBrandId"
      }
    }
  }
}

Configure Cursor

Add to your Cursor MCP settings (Settings → MCP → Add Server):

{
  "name": "resonance",
  "command": "npx",
  "args": ["@resonance/mcp-server"],
  "env": {
    "RESONANCE_NETWORK": "mainnet",
    "RESONANCE_BRAND_ID": "0xYourBrandId"
  }
}

Environment Variables

Variable	Description	Default
RESONANCE_NETWORK	mainnet or testnet	mainnet
RESONANCE_BRAND_ID	Your brand wallet address	(required)

Finding Your Brand ID

1. Log in to partners.rsnc.network
2. Go to Settings → Account
3. Copy your Brand ID (starts with 0x)

Verify Installation

After configuring, restart your AI assistant and try:

"What Resonance tools do you have available?"

The AI should list all 30 available tools.

Test with a Simple Query

Try asking:

"Show me the Resonance contract addresses"

The AI should return the contract addresses from the MCP resources.

Troubleshooting

"MCP server not found"

1. Verify npm/npx is in your PATH
2. Try installing globally: npm install -g @resonance/mcp-server
3. Check the command path in your config

"Brand ID invalid"

1. Verify your Brand ID is 42 characters
2. Ensure it starts with 0x
3. Check you copied it correctly from Partner Portal

"Tools not appearing"

1. Restart your AI assistant completely
2. Check the MCP configuration file path
3. Verify JSON syntax is correct

"Connection refused"

1. Check your internet connection
2. Verify you're not behind a restrictive firewall
3. Try testnet network first

Network Options

Network	Use Case
mainnet	Production - real RSNC tokens
testnet	Testing - test tokens only

For development, start with testnet:

{
  "env": {
    "RESONANCE_NETWORK": "testnet",
    "RESONANCE_BRAND_ID": "0xYourTestBrandId"
  }
}

What's Next?

• Tools Reference — See all 30 tools
• Resources Reference — See all 11 resources
• Examples — Real conversation examples