Skip to main content

Talon.One MCP server Closed beta

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.

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

Prerequisites​

  • You have Node.js installed on your machine.
  • You have admin rights in Talon.One, or you asked a Talon.One admin from your organization to generate the MCP connection API key for you.

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. In the Campaign Manager, click Account > Tools > MCP Connections.
  2. Click Create Key.
  3. In Name, type a name to identify the key.
  4. In Expiration date, select a date.
  5. Click Create Key.
  6. 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 /v1/mcp/entrypoint to the end of your deployment URL. Example: https://mycompany.europe-west1.talon.one/v1/mcp/entrypoint

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": {
    "talon-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://YOUR_DEPLOYMENT_URL/v1/mcp/entrypoint",
        "--header",
        "Authorization: Bearer ${MCP_AUTH_TOKEN}"
      ],
      "env": {
        "MCP_AUTH_TOKEN": "YOUR_API_KEY"
      }
    }
  }
}
4

Connect to your MCP client​

To connect Claude Desktop to the Talon.One MCP server:

  1. Open Settings > Developer.
  2. Click Edit Config to open claude_desktop_config.json.
  3. Add the configuration JSON you generated above to the file.
  4. Save the file and restart Claude Desktop.

Claude Desktop automatically loads the Talon.One MCP tools on restart.