# Tango MCP

> Tango MCP connects your AI agent directly to the Tango reward platform, allowing you to manage gift card rewards and customer accounts through natural conversation. Use it to instantly distribute digital incentives, track funding balances, place bulk orders, or browse global brand catalogs without leaving your chat interface.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** gift-cards, rewards-api, incentives, digital-payments, customer-loyalty, payouts

## Description

This connection lets your AI client handle all things related to corporate rewards. You can automatically process reward payouts—whether you're running a loyalty campaign or giving out employee bonuses. The system manages the entire lifecycle: from checking current exchange rates and listing available brands, to placing an automated order for specific gift cards.

Need to manage who receives what? Your agent can list all customers or create new accounts on the fly. If you're dealing with a complex payout cycle, the MCP lets you check account balances, monitor funding sources, and track every single order ID in real time. When you connect this via Vinkius, your AI client treats Tango like another native service—you just talk to it. No logging into dashboards, no copy-pasting IDs, just straight conversation control over your entire digital reward ecosystem.

## Tools

### create_account
Creates a brand new funding account for a customer in the system.

### create_customer
Adds a completely new individual or group of customers to your records.

### create_order
Initiates and places a reward order for digital gift cards or credits.

### get_account
Retrieves the current balance of a specific funding account ID.

### get_catalog
Lists every reward brand and type available globally for purchase or distribution.

### get_customer
Pulls detailed information about a specific customer ID.

### get_exchange_rates
Provides the current currency exchange rates needed for multi-currency payouts.

### get_order
Checks the current status and details of a specific, existing order ID.

### list_accounts
Lists all associated funding accounts linked to a given customer group.

### list_customers
Retrieves a full list of every customer record you have set up in the platform.

### list_funding_sources
Shows all available financial methods or sources that can fund your rewards accounts.

### list_orders
Retrieves a history of your most recent reward orders for quick review.

## Prompt Examples

**Prompt:** 
```
Show me all available gift card brands in the catalog.
```

**Response:** 
```
I've retrieved the global catalog. You have access to hundreds of brands including Amazon, Starbucks, Apple, and Target. Which country or category are you interested in?
```

**Prompt:** 
```
What is the current balance of account 'acc_10293'?
```

**Response:** 
```
Fetching balance... The account 'acc_10293' currently has a balance of $1,250.00 USD. You have sufficient funds for your upcoming reward distributions.
```

**Prompt:** 
```
Send a $25 Amazon gift card (UTID: AMZN-US-2500) to 'john.doe@example.com'.
```

**Response:** 
```
Order initiated! I've triggered the delivery of a $25.00 Amazon reward to john.doe@example.com. The order ID is ord_88231. I'll let you know once the status shows it's successfully delivered.
```

## Capabilities

### Process and track rewards orders
Place new gift card orders for specific brands or manage existing orders to check their current status.

### Manage customer records
List all registered customers, create new user accounts, or retrieve detailed information on any client.

### Check financial health and balances
Get real-time account balances, list funding sources for a customer, or pull current currency exchange rates.

### Browse global reward catalogs
See every available brand of prepaid cards, gift cards, and non-profit donations supported by Tango.

## Use Cases

### Running a Quarterly Employee Bonus
The HR manager needs to give 50 employees bonuses. Instead of running 50 individual transactions, they ask their agent to use `get_catalog` first to confirm the available brands. Then, using `list_customers`, they pull all recipients and send a single command to place automated orders for rewards via `create_order`.

### Investigating an Overdue Payout
An operations lead notices a discrepancy in the payout ledger. They use `list_orders` to get a recent list, then select a problematic order ID. The agent uses `get_order` and `get_account` simultaneously to confirm both the original status and the current funding balance.

### Setting up a New Regional Campaign
A marketing team needs to launch incentives in Mexico, which uses a different currency. They ask their agent for available brands (`get_catalog`) and then check `get_exchange_rates` before submitting the final payout command using `create_order`, ensuring correct pricing.

### Onboarding New Client Groups
An account manager needs to set up three new corporate clients. Instead of manual form filling, they ask their agent to use `list_customers` to check for existing records, then execute the `create_customer` and `create_account` tools sequentially.

## Benefits

- Stop manually tracking balances. With the `get_account` tool, you instantly pull real-time account balances without opening a single spreadsheet or dashboard.
- Streamline your global payouts. Use `get_exchange_rates` to ensure every reward is accurately valued, regardless of international currency differences.
- Never lose track of a promotion again. You can use the `create_order` tool and then follow up with `get_order` to monitor its exact status until delivery confirmation.
- Simplify customer data management. Instead of complex database queries, you just ask your agent to list all customers or retrieve specific details using `get_customer`.
- Maximize outreach efficiency. The `list_customers` tool gives you a full roster of contacts, letting you coordinate large-scale loyalty payouts in minutes.
- Handle bulk setup instantly. You can use the `create_customer` and `create_account` tools together to onboard new groups and set up funding accounts simultaneously.

## How It Works

The bottom line is that you manage complex financial and customer payouts entirely through natural conversation with your AI client.

1. Subscribe to the MCP in Vinkius and provide your required Tango Platform Name and key.
2. Your AI client authenticates the connection, making all reward and customer data available for conversational commands.
3. You simply ask your agent to 'check the balance' or 'order a gift card,' and it executes the necessary actions via the connected tools.

## Frequently Asked Questions

**How do I find out what gift card brands are available in the Tango MCP?**
You use the `get_catalog` tool. This immediately pulls a comprehensive list of every brand, including Amazon and Starbucks, so you know exactly what incentives you can offer.

**Can I use the Tango MCP to check multiple customer balances at once?**
Yes, if you have the IDs, you can run `get_account` for several accounts. It pulls all current funding balances into one clear report for comparison.

**Is creating a new customer in the Tango MCP difficult?**
No, it's straightforward. You just use the `create_customer` tool and provide the necessary details; the agent handles the rest of the record creation.

**What if I need to change currency for an order using Tango MCP?**
Before ordering, run `get_exchange_rates`. This gives you the current rates needed so that when you use `create_order`, you know exactly how much local currency is required.

**Does the Tango MCP help me manage my order history?**
Absolutely. You can run `list_orders` to see a summary of recent purchases, and then use `get_order` on any specific ID for full details.