Overview
What is Twilio Agent Payments MCP Server?
An MCP (Model Context Protocol) server that enables handling agent-assisted payments via the Twilio API, with enhanced features for asynchronous callbacks and guided workflow through contextual prompts.
How to use Twilio Agent Payments MCP Server?
Run directly with npx: npx twilio-agent-payments-mcp-server <accountSid> <apiKey> <apiSecret>, or install globally via npm and run the same command. Required environment variables include TOKEN_TYPE, CURRENCY, PAYMENT_CONNECTOR, and NGROK_AUTH_TOKEN. For Claude Desktop, add a JSON configuration entry pointing to the server with credentials and env variables. For custom MCP host applications, implement an MCP client and connect to the server; the server automatically registers its tools, resources, and prompts.
Key features of Twilio Agent Payments MCP Server
- Process secure payments during voice calls via Twilio
- Capture and tokenize payment information for PCI compliance
- Asynchronous callbacks via MCP Resources
- Guided workflow with MCP Prompts for each payment step
- Support for re-entry of payment information
- Uses Twilio API Keys for improved security
Use cases of Twilio Agent Payments MCP Server
- Securely collect card details during a live voice call
- Tokenize payment data and handle PCI‑compliant processing
- Guide an LLM through a step‑by‑step payment flow with contextual prompts
- Allow customers to correct or re‑enter payment information
- Integrate payment capabilities into any MCP‑compatible host application
FAQ from Twilio Agent Payments MCP Server
How do I install and run the server?
Run via npx: npx twilio-agent-payments-mcp-server <accountSid> <apiKey> <apiSecret>, or install globally with npm install -g twilio-agent-payments-mcp-server and then run the same command with required arguments.
What are the required parameters and environment variables?
Command‑line arguments: accountSid, apiKey, apiSecret. Environment variables: TOKEN_TYPE, CURRENCY, PAYMENT_CONNECTOR, and NGROK_AUTH_TOKEN. Optionally set NGROK_CUSTOM_DOMAIN.
How do I configure the server for Claude Desktop?
Add an entry to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) with the command, arguments, and environment variables as shown in the README.
How does the server ensure payment security?
It tokenizes payment information for PCI compliance and uses Twilio API Keys instead of Auth Tokens for better access control and credential revocation.
Can customers re‑enter payment information if needed?
Yes, the server supports re‑entry of payment information, allowing customers to correct or re‑provide card details during the payment flow.
