MCP Server Setup Guide

A step-by-step guide to connecting your AI assistant to the hosted Dual MCP server. No local Node.js install is required. Configure your client, add an API key, and the agent can immediately work with templates, objects, actions, wallets, webhooks, and sequencer data.

Prerequisites

• A Dual account
• A Dual API key from the Dual Console
• An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code

Authentication

The hosted MCP server expects your API key in the X-API-Key header.

Option A: API Key

Recommended for persistent access and automation.

Option B: Interactive Login

If your client supports it, the agent can also use dual_login to authenticate for the current session.

Client Configuration

Claude Desktop

Add the following to:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "dual": {
      "url": "https://mcp-testnet.dual.network/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Cursor

Add the same MCP definition to .cursor/mcp.json:

{
  "mcpServers": {
    "dual": {
      "url": "https://mcp-testnet.dual.network/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Claude Code

Add the hosted server from the terminal:

claude mcp add dual --transport sse https://mcp-testnet.dual.network/mcp

Then provide the API key via your Claude Code configuration or environment setup.

Usage Examples

Create a Reward Token

Typical tool flow:

1. dual_create_template
2. dual_create_action_type
3. dual_create_face
4. dual_execute_action

Monitor Platform Activity

Typical tool flow:

1. dual_public_get_stats
2. dual_list_batches
3. dual_list_checkpoints

Set Up Webhooks

Typical tool flow:

1. dual_create_webhook
2. dual_test_webhook
3. dual_list_webhooks

Troubleshooting

Authentication required

Confirm your API key is present and that the client is sending it as X-API-Key.

Tools not appearing

Restart the client after editing configuration and verify the MCP server entry points to https://mcp-testnet.dual.network/mcp.

Rate limit exceeded

Retry after a pause, or batch related operations when possible.

Next Steps

• MCP Server Reference
• Claude Plugins
• Claude Code Plugins
• Learn Dual