Tango MCP - Troubleshooting

Common Issues and Solutions

Authentication Failures

Problem: "Authentication failed" error
Solution:

• Verify your platform name and key are correct
• Ensure credentials are properly set in environment variables
• Check if your account is active with Tango Card

Order Creation Failures

Problem: "Insufficient funds" or "Invalid UTID"
Solution:

• Check account balance using Get_Customer
• Verify UTID exists using Get_Catalog_Items
• Ensure amount is within valid range for the gift card

Missing Catalog Items

Problem: Expected gift cards not appearing in catalog
Solution:

• Check if filtering parameters are too restrictive
• Verify your account has access to the desired brands
• Contact Tango Card support for catalog access issues

Email Delivery Issues

Problem: Recipients not receiving gift cards
Solution:

• Verify email addresses are correct
• Check spam/junk folders
• Use Get_Order_Resends to check resend attempts
• Consider setting sendEmail to false and handling delivery yourself

Debug Mode

For detailed API interactions, you can enable debug logging by setting:

DEBUG=tango-qa:*

This will log all API requests and responses for troubleshooting.

Support and Resources

• Tango Card API Documentation: https://developers.tangocard.com
• MCP Documentation: https://modelcontextprotocol.io
• Issues and Bug Reports: Submit via GitHub repository
• Tango Card Support: Contact your Tango Card account manager

Note: This guide covers the digital gift card functionality only. Physical card operations are not supported by this MCP server.