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.

What credentials does it need?

It reads `TOKEN_TYPE`, `CURRENCY`, `PAYMENT_CONNECTOR`, `NGROK_AUTH_TOKEN`, `NGROK_CUSTOM_DOMAIN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Twilio Agent Payments MCP Server

# Twilio Agent Payments MCP Server An MCP (Model Context Protocol) server that enables handling agent-assisted payments via the Twilio API, with

Local serverstdioTypeScript

What is the Twilio Agent Payments MCP Server?

Twilio Agent Payments MCP Server An MCP (Model Context Protocol) server that enables handling agent-assisted payments via the Twilio API, with enhanced features

What the server does

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
startPaymentCapture	Parameters: - callSid: The Twilio Call SID for the active call
captureCardNumber	Parameters: - callSid: The Twilio Call SID for the active call - paymentSid: The Twilio Payment SID for the payment session - captureType: Set to 'payment-card-number'
captureSecurityCode	Parameters: - callSid: The Twilio Call SID for the active call - paymentSid: The Twilio Payment SID for the payment session - captureType: Set to 'security-code'
captureExpirationDate	Parameters: - callSid: The Twilio Call SID for the active call - paymentSid: The Twilio Payment SID for the payment session - captureType: Set to 'expiration-date'
completePaymentCapture	Parameters: - callSid: The Twilio Call SID for the active call - paymentSid: The Twilio Payment SID for the payment session

How to install the Twilio Agent Payments MCP Server

claude mcp add twilio-agent-payments --env TOKEN_TYPE=your-value --env CURRENCY=your-value --env PAYMENT_CONNECTOR=your-value --env NGROK_AUTH_TOKEN=your-value --env NGROK_CUSTOM_DOMAIN=your-value -- npx -y twilio-agent-payments-mcp-server

Configuration

Variable	Description	Required
TOKEN_TYPE	Credential the server authenticates with.	Yes
CURRENCY	Configuration value read at startup.	Optional
PAYMENT_CONNECTOR	Configuration value read at startup.	Optional
NGROK_AUTH_TOKEN	Credential the server authenticates with.	Yes
NGROK_CUSTOM_DOMAIN	Configuration value read at startup.	Optional

Example prompts to try

“Use Twilio Agent Payments to startPaymentCapture.”
“Use Twilio Agent Payments to captureCardNumber.”
“Use Twilio Agent Payments to captureSecurityCode.”

Frequently asked questions

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.