Deshartman Twilio Agent Payments MCP Server

🚀 Twilio MCP Server

Twilio's MCP (MCP Protocol) server is a powerful tool for integrating with Claude Desktop. It offers developers a rich set of APIs and features to simplify payment processing, voice calls, and other communication-related tasks.

🚀 Quick Start

Initializing the Server

To manually start the MCP server for testing, run the following commands:

# Run with actual credentials
node build/index.js "your_account_sid_here" "your_api_key_here" "your_api_secret"

# Or use the npm script (development environment)
npm run dev -- "your_account_sid_here" "your_api_key_here" "your_api_secret"

When used in Claude Desktop, the server starts automatically.

✨ Features

1. Payment Processing

• Payment Session Creation: Provides the createPaymentSession method to initialize a new payment session.
• Payment Information Capture: Offers the capturePaymentInfo method to collect and process user payment information.
• Payment Status Query: Supplies the getPaymentStatus method to obtain the status of a specific payment session.

2. Voice Communication

• Call Connection: Provides the connectCall method to establish a new call connection.
• Call Forwarding: Offers the forwardCall method to forward an incoming call to a specified number.
• Media Processing: Supports audio and video stream processing through Twilio's Media API.

3. Logging

• Event-driven Logging Architecture: All tools and resource classes inherit from Node.js' EventEmitter and emit the 'log' event to record operations.
• Log Level Support: Supports the following log levels: info, error, debug, and warn (automatically converted to the info level).

4. Callback Data Processing

• Initial Connector Data: Twilio sends connector data when a payment session is first created.
• Captured Data Updates: Twilio sends updated callback data when payment information is captured.

📚 Documentation

Logging Specification

• Event-driven Logging System: All tools and resource classes inherit from Node.js' EventEmitter and emit the 'log' event.
• Log Forwarding: These events are captured and forwarded to the MCP server's logging system:

// Event listener for tool logs
startPaymentCaptureTool.on(LOG_EVENT, logToMcp);
captureCardNumberTool.on(LOG_EVENT, logToMcp);
// Other tools...

Payment Callback Data Structure

Initial Connector Data

When a payment session is first created, Twilio sends the following data:

{
  "PaymentConnector": "PGP_MOCK",
  "DateCreated": "2021-08-10T03:55:53.408Z",
  "PaymentMethod": "credit-card",
  "CallSid": "CAzzzzz",
  "ChargeAmount": "100.00",
  "Currency": "USD"
}

Captured Data Updates

When payment information is captured, Twilio sends the following updated data:

{
  "PaymentStatus": "captured",
  "Amount": "100.00",
  "TransactionId": "ABC123DEF"
}

Compatibility Description

Compatibility with MCP Check Tool

• Log Level Handling: Automatically converts the 'warn' level to the 'info' level.

Security Precautions

• PCI Compliance: The server adheres to PCI standards to ensure the secure storage and transmission of payment information.
• Credential Management: It is recommended to use environment variables or a secure credential management system to store sensitive information.

Error Handling

Common Errors

1. Invalid Credentials: Ensure that the provided Account SID, API Key, and Secret are valid Twilio credentials.
2. Network Issues: Check the network connection between the server and Twilio services.

Error Log Example

{
  "error": {
    "code": "401 Unauthorized",
    "message": "Invalid authentication credentials"
  }
}

Summary

Twilio's MCP server is a powerful and flexible tool that enables developers to efficiently handle payment and communication-related tasks. By following the guidelines in this document, you can easily integrate and configure the server to meet various requirements.