MCP Server

Connect your AI to Duel

This is the Duel MCP (Model Context Protocol) server. Connect your AI assistant to build and manage advocacy programmes faster — search tasks, set up labels, browse programmes, and more.

Endpoint

https://mcp.duel.me
Streamable HTTP transport · OAuth 2.1 authentication · duel:read duel:write

Authentication

On first connection, your MCP client will automatically discover OAuth settings and open a browser for login. No API keys required.

1 OAuth discovery → 2 Browser login → 3 Token issued → 4 Connected

Capabilities

Tasks

  • Search tasks
  • Get a single task
  • Create a task
  • Update a task
  • Delete a task
  • Expire a task
  • Take a task offline

Groups

  • Search groups
  • Get a single group
  • Create a group
  • Update a group
  • Delete a group

Labels

  • Search labels
  • Get a single label
  • Create a label
  • Update a label
  • Delete a label
  • Get custom fields

Segments

  • Search segments
  • Get a single segment
  • Create a segment
  • Update a segment
  • Delete a segment

Advocates

  • List and browse members
  • Search members for labels

Describe what you need in plain language — your AI assistant handles the API calls.

Setup Guide

Claude Code
  1. Run the following command to add the Duel MCP server:
claude mcp add --transport http --scope user duel https://mcp.duel.me
  1. Launch Claude Code by running claude in your terminal
  2. Run /mcp to verify the server appears in your MCP connections list
  3. Start a new conversation and use a Duel tool — Claude Code will prompt you to authenticate
  4. A browser window will open — log in with your Duel email, password, and MFA code
  5. Return to Claude Code — you're now connected
Claude Desktop
  1. Open Claude Desktop and click your profile name in the bottom-left corner
  2. Select Settings
  3. Navigate to the Connectors section
  4. Click Add custom connector
  5. Enter the URL: https://mcp.duel.me
  6. Click Save to close the dialog
  7. Back in Connectors, find Duel and click Connect
  8. Log in with your Duel email, password, and MFA code
  9. On the consent screen, click Allow to authorize access
Powered by Duel · Model Context Protocol