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.

Features

• Process secure payments during voice calls via Twilio
• Capture payment information (card number, security code, expiration date)
• Tokenize payment information for PCI compliance
• Asynchronous callbacks via MCP Resources
• Guided workflow with MCP Prompts for each step of the payment process
• Support for re-entry of payment information
• Integrates with MCP clients like Claude Desktop
• Secure credential handling
• Uses Twilio API Keys for improved security
• Event-based logging architecture

Installation

You can use this server directly via npx:

npx twilio-agent-payments-mcp-server <accountSid> <apiKey> <apiSecret>

Or install it globally:

npm install -g twilio-agent-payments-mcp-server
twilio-agent-payments-mcp-server <accountSid> <apiKey> <apiSecret>

Environmental Parameters

When installing the server, you need to provide the following parameters:

1. Command-line arguments (required):

   • accountSid: Your Twilio Account SID
   • apiKey: Your Twilio API Key
   • apiSecret: Your Twilio API Secret

2. Environment variables (set before running the server):

   • TOKEN_TYPE: Type of token to use for payments (e.g., 'reusable', 'one-time')
   • CURRENCY: Currency for payments (e.g., 'USD', 'EUR')
   • PAYMENT_CONNECTOR: Payment connector to use with Twilio
   • NGROK_AUTH_TOKEN: Your Ngrok authentication token (required for callback handling)
   • NGROK_CUSTOM_DOMAIN: Optional custom domain for Ngrok

Example with environment variables:

TOKEN_TYPE=reusable CURRENCY=USD PAYMENT_CONNECTOR=your_connector NGROK_AUTH_TOKEN=your_token npx twilio-agent-payments-mcp-server <accountSid> <apiKey> <apiSecret>

See the Configuration section below for more details on these parameters.

Configuration

The server requires the following parameters:

• accountSid: Your Twilio Account SID (must start with 'AC', will be validated)
• apiKey: Your Twilio API Key (starts with 'SK')
• apiSecret: Your Twilio API Secret

Environment Variables

The following environment variables are used for configuration:

• TOKEN_TYPE: Type of token to use for payments (e.g., 'reusable', 'one-time')
• CURRENCY: Currency for payments (e.g., 'USD', 'EUR')
• PAYMENT_CONNECTOR: Payment connector to use with Twilio
• NGROK_AUTH_TOKEN: Your Ngrok authentication token (required for callback handling)
• NGROK_CUSTOM_DOMAIN: Optional custom domain for Ngrok

Note: Twilio credentials (accountSid, apiKey, apiSecret) are provided as command-line arguments, not environment variables.

Security Note

This server uses API Keys and Secrets instead of Auth Tokens for improved security. This approach provides better access control and the ability to revoke credentials if needed. For more information, see the Twilio API Keys documentation.

Usage with Claude Desktop

Local Development

For local development (when the package is not published to npm), add the following to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "twilio-agent-payments": {
      "command": "node",
      "args": [
        "/PATHTONODE/twilio-agent-payments-mcp-server/build/index.js",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here"
      ],
      "env": {
        "TOKEN_TYPE": "reusable",
        "CURRENCY": "USD",
        "PAYMENT_CONNECTOR": "your_connector_name",
        "NGROK_AUTH_TOKEN": "your_ngrok_auth_token_here",
        "NGROK_CUSTOM_DOMAIN": "your_custom_domain_here" // Optional
      }
   

... [View full README on GitHub](https://github.com/deshartman/twilio-agent-payments-mcp-server#readme)