Skip to main content

Talon.One MCP server Limited Access

Feature access
This feature is in the limited access phase. To unlock this feature, contact your Customer Success Manager.

The Talon.One MCP server connects your Talon.One environment to AI agents.

It gives agents secure, read-only access to your campaigns, customers, coupons, and loyalty programs. Agents provide answers about your promotions without you having to navigate the Campaign Manager or write code.

The Talon.One MCP server enables campaign managers, support agents, and anyone using AI agents to, for example:

  • Answer questions in plain language about campaigns and loyalty programs.
  • Identify performance trends and pain points without building reports or navigating the Campaign Manager.
  • Investigate customer sessions and eligibility issues in seconds.

Supported tasks​

The Talon.One MCP server gives AI agents tools to read and understand your Talon.One data.

When connected, agents can, for example:

  • Explain the logic behind specific campaign rules and loyalty transactions.
  • Confirm if a campaign is live and check its current budget limits.
  • Analyze a customer's point balance, transaction history, and tier status to explain specific loyalty-related changes.
  • Provide accurate answers pulled directly from your live environment about current attributes, rules, campaigns, and limits.
important

The Talon.One MCP server uses an MCP-specific API key and follows your account permissions. Third-party AI services may process your data. Review your company AI policies before you connect tools that access customer data.

Prompt examples​

For marketing teams​

How is our summer sale campaign performing?

The AI agent can use the MCP server to:

  • Get redemption rates, budget usage, and loyalty points from live data.
  • Summarize referral conversions and audience engagement.

What targeting rules are configured on our VIP campaign?

The AI agent can use the MCP server to:

  • Explain the specific rules and audience configured for the campaign in plain language.
  • Provide accurate answers pulled directly from your live environment.

For support teams​

Why didn't this promotion apply for this customer?

The AI agent can use the MCP server to:

  • Evaluate the rule logic to find where the customer failed to meet requirements.
  • Identify if specific coupon limits or profile attributes blocked the promotion.

What's the loyalty status for customer X?

The AI agent can use the MCP server to:

  • Check the customer's point balance, transaction history, and tier status.
  • Provide an accurate answer pulled directly from your live environment.

Connect the MCP server​

Each Talon.One environment provides its own MCP server URL. To connect an agent, create an API key and use it to authenticate with the MCP server from your preferred MCP host, such as Claude or Cursor.

1

Create an API key​

Create an MCP connection API key in the Campaign Manager:

  1. Ensure you have admin permissions.
  2. In the Campaign Manager, click Account > Tools > MCP Connections.
  3. Click Create New Key.
  4. In Key name, type a name to identify the key.
  5. In Key expiration date, select a date.
  6. Click Create Key.
  7. Copy the key. You can use it immediately.
note

You cannot display the API key after this step for security reasons. If you lose the value, create a new API key.

2

Form an MCP server URL​

Your MCP server URL is based on your specific deployment address. To create it, add /mcp to the end of your deployment URL. Example: https://mycompany.europe-west1.talon.one/mcp

3

Generate configuration JSON​

To complete the setup, generate a personalized configuration JSON using the generated API key and the MCP server URL. For example:

{
  "mcpServers": {
    "T1-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://YOUR_DEPLOYMENT_URL/mcp",
        "--header",
        "API_Key: ${API_KEY}"
      ],
      "env": {
        "API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Use MCP clients​

The Talon.One MCP server supports the following MCP clients:

  • Claude Desktop
  • Claude Code
  • Cursor
  • Gemini CLI
  • ChatGPT CLI
  • Codex CLI
  • Most other stdio-compatible MCP clients

To connect Claude Code to the Talon.One MCP server, use the following CLI command, where

  • YOUR_DEPLOYMENT_URL is the base URL of your Talon.One deployment, for example, mycompany.europe-west1.talon.one.
  • YOUR_API_KEY is the API key for your MCP connection.
claude mcp add --transport http --scope local T1-mcp-server https://YOUR_DEPLOYMENT_URL/mcp --env API_KEY="YOUR_API_KEY" --header "API_Key: ${API_KEY}"