Build an AI Agent with MCP

Connect Claude or any MCP-compatible AI to the hosted Dual MCP server.

What You'll Build

The Model Context Protocol (MCP) lets AI agents interact with external tools natively. Dual's MCP server exposes 80 tools across 14 API modules, so an AI agent can create templates, mint tokens, execute actions, and query data using natural language. In this tutorial you'll connect Claude to the hosted MCP endpoint and build a complete tokenization workflow driven by conversation.

Step 1, Use the Hosted Endpoint

The Dual MCP server is hosted at:

text
https://mcp-testnet.dual.network/mcp

Step 2, Configure Claude Desktop

Add the Dual server to your Claude Desktop config:

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

Config file locations:

Restart Claude Desktop after saving.

Step 3, Authenticate via Chat

If you didn't set an API key, authenticate interactively:

text
You: Log me into Dual with email dev@example.com
Claude: [calls dual_login] Logged in as dev@example.com. Session authenticated.

Step 4, Build a Token with Natural Language

Describe what you want and let the AI handle the API calls:

text
You: Create a reward token template called "Coffee Stamp Card" with properties
for stamps (number, default 0), max_stamps (10), and redeemed (false).
Claude: [calls dual_create_template]
Created template "Coffee Stamp Card" (ID: tmpl_abc123).
You: Mint 5 of those for wallet "wallet_xyz"
Claude: [calls dual_execute_action to mint 5 objects]
Minted 5 Coffee Stamp Card objects.
You: Set up a webhook to notify me when any get redeemed
Claude: [calls dual_create_webhook]
Webhook created for object.updated events.

Step 5, Available Modules

The MCP server exposes 14 modules with 80 tools total:

Alternative: Claude Code CLI

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

Security Note: The MCP server is hosted. Your client authenticates using X-API-Key, so keep your API key scoped appropriately and store it securely in your client configuration or shell profile.

Summary

You've connected an AI agent to the Dual platform via MCP. The agent can now autonomously create templates, mint tokens, manage organizations, and execute actions through natural conversation. For the full reference, see the MCP Server docs and Setup Guide.