[{"_1":2,"_319":-5,"_320":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_260":261},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"BOT","id",7058884,"membership","referenceId","01971406-43e3-74e8-b880-2f000258007a","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_68":-5,"_69":28,"_29":70,"_178":179,"_259":131},"availableLocales",[28,40,47,54,61],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","An MCP server that enables secure, PCI-compliant payment processing during voice calls via Twilio API, providing asynchronous callbacks and guided workflow for agent-assisted payments.","name","Twilio Agent Payments MCP Server","readme","# Twilio Agent Payments MCP Server\n\nAn 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.\n\n## Features\n\n- Process secure payments during voice calls via Twilio\n- Capture payment information (card number, security code, expiration date)\n- Tokenize payment information for PCI compliance\n- Asynchronous callbacks via MCP Resources\n- Guided workflow with MCP Prompts for each step of the payment process\n- Support for re-entry of payment information\n- Integrates with MCP clients like Claude Desktop\n- Secure credential handling\n- Uses Twilio API Keys for improved security\n- Event-based logging architecture\n\n## Installation\n\nYou can use this server directly via npx:\n\n```bash\nnpx twilio-agent-payments-mcp-server \n```\n\nOr install it globally:\n\n```bash\nnpm install -g twilio-agent-payments-mcp-server\ntwilio-agent-payments-mcp-server \n```\n\n### Environmental Parameters\n\nWhen installing the server, you need to provide the following parameters:\n\n1. **Command-line arguments** (required):\n - `accountSid`: Your Twilio Account SID\n - `apiKey`: Your Twilio API Key\n - `apiSecret`: Your Twilio API Secret\n\n2. **Environment variables** (set before running the server):\n - `TOKEN_TYPE`: Type of token to use for payments (e.g., 'reusable', 'one-time')\n - `CURRENCY`: Currency for payments (e.g., 'USD', 'EUR')\n - `PAYMENT_CONNECTOR`: Payment connector to use with Twilio\n - `NGROK_AUTH_TOKEN`: Your Ngrok authentication token (required for callback handling)\n - `NGROK_CUSTOM_DOMAIN`: Optional custom domain for Ngrok\n\nExample with environment variables:\n```bash\nTOKEN_TYPE=reusable CURRENCY=USD PAYMENT_CONNECTOR=your_connector NGROK_AUTH_TOKEN=your_token npx twilio-agent-payments-mcp-server \n```\n\nSee the Configuration section below for more details on these parameters.\n\n## Configuration\n\nThe server requires the following parameters:\n\n- `accountSid`: Your Twilio Account SID (must start with 'AC', will be validated)\n- `apiKey`: Your Twilio API Key (starts with 'SK')\n- `apiSecret`: Your Twilio API Secret\n\n### Environment Variables\n\nThe following environment variables are used for configuration:\n\n- `TOKEN_TYPE`: Type of token to use for payments (e.g., 'reusable', 'one-time')\n- `CURRENCY`: Currency for payments (e.g., 'USD', 'EUR')\n- `PAYMENT_CONNECTOR`: Payment connector to use with Twilio\n- `NGROK_AUTH_TOKEN`: Your Ngrok authentication token (required for callback handling)\n- `NGROK_CUSTOM_DOMAIN`: Optional custom domain for Ngrok\n\nNote: Twilio credentials (accountSid, apiKey, apiSecret) are provided as command-line arguments, not environment variables.\n\n### Security Note\n\nThis 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](https://www.twilio.com/docs/usage/requests-to-twilio).\n\n## Usage with Claude Desktop\n\n### Local Development\n\nFor 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):\n\n```json\n{\n \"mcpServers\": {\n \"twilio-agent-payments\": {\n \"command\": \"node\",\n \"args\": [\n \"/PATHTONODE/twilio-agent-payments-mcp-server/build/index.js\",\n \"your_account_sid_here\",\n \"your_api_key_here\",\n \"your_api_secret_here\"\n ],\n \"env\": {\n \"TOKEN_TYPE\": \"reusable\",\n \"CURRENCY\": \"USD\",\n \"PAYMENT_CONNECTOR\": \"your_connector_name\",\n \"NGROK_AUTH_TOKEN\": \"your_ngrok_auth_token_here\",\n \"NGROK_CUSTOM_DOMAIN\": \"your_custom_domain_here\" // Optional\n }\n }\n }\n}\n```\n\nReplace the values with your actual Twilio credentials and configuration.\n\n### After Publishing to npm\n\nOnce the package is published to npm, you can use the following configuration:\n\n```json\n{\n \"mcpServers\": {\n \"twilio-agent-payments\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\", \n \"twilio-agent-payments-mcp-server\",\n \"your_account_sid_here\",\n \"your_api_key_here\",\n \"your_api_secret_here\"\n ],\n \"env\": {\n ...process.env, // Include existing environment variables so child process has access to the path\n \"TOKEN_TYPE\": \"reusable\",\n \"CURRENCY\": \"USD\",\n \"PAYMENT_CONNECTOR\": \"your_connector_name\",\n \"NGROK_AUTH_TOKEN\": \"your_ngrok_auth_token_here\",\n \"NGROK_CUSTOM_DOMAIN\": \"your_custom_domain_here\" // Optional\n }\n }\n }\n}\n```\n\n## Integration with Host Applications\n\nOne of the key advantages of the Model Context Protocol (MCP) is that it eliminates the need for extensive manual configuration of LLM context. The MCP server automatically provides all necessary tool definitions, resource templates, and capabilities to the LLM client.\n\n### Setting Up Your Host Application\n\nTo integrate this MCP server into your own host application:\n\n1. **Implement an MCP Client**: Use an existing MCP client library or implement the MCP client protocol in your application.\n\n2. **Connect to the MCP Server**: Configure your application to connect to the Twilio Agent Payments MCP server.\n\n3. **Let the Protocol Handle the Rest**: The MCP server will automatically:\n - Register its tools and resources with your client\n - Provide input schemas for all tools\n - Supply contextual prompts to guide the LLM through the payment flow\n\nNo manual definition of tools or resources is required in your LLM's context - the MCP protocol handles this discovery automatically.\n\n### Example Integration Code\n\nHere's a simplified example of how to integrate with an MCP client:\n\n```javascript\n// Initialize your MCP client\nconst mcpClient = new McpClient();\n\n// Connect to the Twilio Agent Payments MCP server\nawait mcpClient.connectToServer({\n name: \"twilio-agent-payments\",\n // Connection details depend on your specific MCP client implementation\n // This could be a WebSocket URL, stdio connection, or other transport\n});\n\n// The client will automatically discover available tools and resources\n\n// When the LLM wants to use a tool, your application can handle it like this:\nfunction handleLlmToolRequest(toolRequest) {\n // The toolRequest would contain:\n // - server_name: \"twilio-agent-payments\"\n // - tool_name: e.g., \"startPaymentCapture\"\n // - arguments: e.g., { callSid: \"CA1234567890abcdef\" }\n \n return mcpClient.callTool(toolRequest);\n}\n\n// Similarly for resources:\nfunction handleLlmResourceRequest(resourceRequest) {\n // The resourceRequest would contain:\n // - server_name: \"twilio-agent-payments\"\n // - uri: e.g., \"payment://CA1234567890abcdef/PA9876543210abcdef/status\"\n \n return mcpClient.accessResource(resourceRequest);\n}\n```\n\n### Minimal LLM Context Required\n\nThe LLM only needs to know that it can use the Twilio Agent Payments MCP server for handling payments. A simple instruction in your system prompt is sufficient:\n\n```\nYou have access to a Twilio Agent Payments MCP server that can help process secure payments during voice calls. \nWhen a customer wants to make a payment, you can use the tools provided by this server to securely capture \npayment information while maintaining PCI compliance.\n\nThe server will guide you through the payment process with contextual prompts at each step.\n```\n\nThe MCP server itself provides all the detailed tool definitions, input schemas, and contextual prompts to guide the LLM through the payment flow.\n\n## Developer Implementation Notes\n\nThis section explains how the MCP server implementation is organized across different components and files, focusing on the architecture patterns used.\n\n### Component Organization\n\nThe server implementation is split across several directories:\n\n1. **src/index.ts**: The main entry point that:\n - Initializes the MCP server\n - Initializes the TwilioAgentPaymentServer singleton\n - Discovers and registers all components with the MCP server via auto-discovery\n - Sets up event listeners for logging\n - Connects the server to the transport layer\n\n2. **src/tools/**: Contains individual tool implementations\n - Each tool is implemented as a factory function that returns an object with name, description, shape, and execute properties\n - Tools handle specific payment operations (e.g., StartPaymentCaptureTool, CaptureCardNumberTool)\n - Each tool defines its input schema using Zod and implements an execute method\n - Tools access the TwilioAgentPaymentServer singleton via getInstance()\n\n3. **src/prompts/**: Contains prompt implementations\n - Each prompt is implemented as a factory function that returns an object with name, description, and execute properties\n - Prompts provide contextual guidance to the LLM for each step of the payment flow\n - Some prompts accept parameters that can be used to customize the prompt content\n\n4. **src/resources/**: Contains resource implementations\n - Resources provide access to data (e.g., PaymentStatusResource)\n - Each resource is implemented as a factory function that returns an object with name, template, description, and read properties\n - Resources access the TwilioAgentPaymentServer singleton via getInstance()\n\n5. **src/api-servers/**: Contains the implementation of the Twilio API client\n - Implements the TwilioAgentPaymentServer as a singleton\n - Handles communication with the Twilio API\n - Manages payment session state\n - Provides static methods for accessing the singleton instance\n\n6. **src/utils/**: Contains utility functions\n - The autoDiscovery.ts file handles automatic discovery and registration of tools, prompts, and resources\n\n### Singleton Pattern for TwilioAgentPaymentServer\n\nA key architectural pattern in this codebase is the use of the Singleton pattern for the TwilioAgentPaymentServer:\n\n```typescript\nclass TwilioAgentPaymentServer extends EventEmitter {\n // Singleton instance\n private static instance: TwilioAgentPaymentServer | null = null;\n\n /**\n * Static method to get the instance\n */\n public static getInstance(): TwilioAgentPaymentServer {\n if (!TwilioAgentPaymentServer.instance) {\n throw new Error('TwilioAgentPaymentServer not initialized. Call initialize() first.');\n }\n return TwilioAgentPaymentServer.instance;\n }\n \n /**\n * Static method to initialize the instance\n */\n public static initialize(accountSid: string, apiKey: string, apiSecret: string): TwilioAgentPaymentServer {\n if (!TwilioAgentPaymentServer.instance) {\n TwilioAgentPaymentServer.instance = new TwilioAgentPaymentServer(accountSid, apiKey, apiSecret);\n }\n return TwilioAgentPaymentServer.instance;\n }\n\n // Private constructor to prevent direct instantiation\n private constructor(accountSid: string, apiKey: string, apiSecret: string) {\n // Initialization code...\n }\n}\n```\n\nBenefits of this approach:\n- Ensures there's only one instance of TwilioAgentPaymentServer throughout the application\n- Eliminates the need to pass the instance through multiple functions\n- Provides a cleaner API with simpler function signatures\n- Makes it easier to access the TwilioAgentPaymentServer from anywhere in the codebase\n\n### Factory Function Pattern\n\nTools, prompts, and resources are implemented using the factory function pattern:\n\n1. **In Tools**: \n ```typescript\n // Example from StartPaymentCaptureTool.ts\n export function startPaymentCaptureTool() {\n // Get the TwilioAgentPaymentServer instance\n const twilioAgentPaymentServer = TwilioAgentPaymentServer.getInstance();\n \n // Create an event emitter for logging\n const emitter = new EventEmitter();\n \n return {\n name: \"startPaymentCapture\",\n description: \"Start a new payment capture session\",\n shape: schema.shape,\n execute: async function execute(params: z.infer, extra: any): Promise {\n // Implementation that calls Twilio API and returns result\n },\n emitter // For attaching event listeners\n }\n }\n ```\n\n2. **In Resources**:\n ```typescript\n // Example from PaymentStatusResource.ts\n export function paymentStatusResource() {\n // Get the TwilioAgentPaymentServer instance\n const twilioAgentPaymentServer = TwilioAgentPaymentServer.getInstance();\n \n // Create an event emitter for logging\n const emitter = new EventEmitter();\n \n return {\n name: \"PaymentStatus\",\n template: new ResourceTemplate(\"payment://{callSid}/{paymentSid}/status\", { list: undefined }),\n description: \"Get the current status of a payment session\",\n read: async (uri: URL, variables: Record, extra: any): Promise => {\n // Implementation that retrieves and formats payment status data\n },\n emitter // For attaching event listeners\n };\n }\n ```\n\n3. **In Prompts**:\n ```typescript\n // Example from a prompt factory function\n export function startCapturePrompt() {\n return {\n name: \"StartCapture\",\n description: \"Prompt for starting the payment capture process\",\n execute: (args: { callSid: string }, extra: RequestHandlerExtra): GetPromptResult | Promise => {\n // Return prompt content\n }\n };\n }\n ```\n\n### Auto-Discovery and Registration\n\nThe server uses an auto-discovery mechanism to find and register all components:\n\n```typescript\n// In src/utils/autoDiscovery.ts\nexport async function discoverComponents(mcpServer: McpServer) {\n // Get the current directory path\n const basePath: string = path.dirname(fileURLToPath(import.meta.url));\n\n await Promise.all([\n discoverTools(mcpServer, path.join(basePath, '../tools')),\n discoverPrompts(mcpServer, path.join(basePath, '../prompts')),\n discoverResources(mcpServer, path.join(basePath, '../resources'))\n ]);\n}\n```\n\nThis approach:\n- Automatically finds all tools, prompts, and resources in their respective directories\n- Dynamically imports and registers them with the MCP server\n- Makes it easy to add new components without modifying the main file\n- Reduces boilerplate code and improves maintainability\n\n### Parameters in Prompts\n\nSome prompts accept parameters that can be used to customize the prompt content. The StartCapturePrompt is a good example:\n\n1. **Parameter Definition**:\n ```typescript\n // In the prompt factory function\n return {\n name: \"StartCapture\",\n description: \"Prompt for starting the payment capture process\",\n schema: { callSid: z.string().describe(\"The Twilio Call SID\") }, // Parameter schema\n execute: (args: { callSid: string }, extra: RequestHandlerExtra) => {\n // Implementation\n }\n };\n ```\n - The schema property defines the parameter schema using Zod\n - In this case, it requires a `callSid` parameter of type string\n\n2. **Parameter Usage in the Prompt**:\n ```typescript\n execute: (args: { callSid: string }, extra: RequestHandlerExtra): GetPromptResult | Promise => {\n const { callSid } = args;\n\n if (!callSid) {\n throw new Error(\"callSid parameter is required\");\n }\n \n return {\n messages: [\n {\n role: \"assistant\",\n content: {\n type: \"text\",\n text: getStartCapturePromptText(callSid), // Use the parameter in the prompt text\n }\n }\n ]\n };\n }\n ```\n - The execute method accepts the parameters as its first argument\n - It can validate the parameters and use them to customize the prompt content\n - In this case, the callSid is used in the prompt text to provide context\n\nThis pattern allows prompts to be dynamic and contextual, providing tailored guidance based on the current state of the payment flow.\n\n## Available Tools\n\n### startPaymentCapture\n\nInitiates a payment capture process for an active call.\n\nParameters:\n- `callSid`: The Twilio Call SID for the active call\n\nIMPORTANT: The StartCapturePrompt.ts requires the user to enter a Call SID from the MCP Client side. This is a required parameter and the prompt will throw an error if it's not provided.\n\nNOTE: When handling Twilio calls, you need to understand which call leg Call SID you are working with. Twilio Payments need to be\nattached to the PSTN side call leg. If applied to the Twilio Client side, the DTMF digits will not be captured. As such this MCP Server\nassumes the correct call leg is being used. Typically it is checked as below:\n\n```javascript\n // Pseudo code: direction of the call\n if (event.CallDirection === \"toPSTN\") {\n theCallSid = event.CallSid;\n }\n\n if (event.CallDirection == \"toSIP\") {\n theCallSid = event.ParentCallSid;\n }\n```\n\nReturns:\n- `paymentSid`: The Twilio Payment SID for the new payment session\n\n### captureCardNumber\n\nStarts the capture of the payment card number.\n\nParameters:\n- `callSid`: The Twilio Call SID for the active call\n- `paymentSid`: The Twilio Payment SID for the payment session\n- `captureType`: Set to 'payment-card-number'\n\nReturns:\n- Status of the card number capture operation\n\n### captureSecurityCode\n\nStarts the capture of the card security code.\n\nParameters:\n- `callSid`: The Twilio Call SID for the active call\n- `paymentSid`: The Twilio Payment SID for the payment session\n- `captureType`: Set to 'security-code'\n\nReturns:\n- Status of the security code capture operation\n\n### captureExpirationDate\n\nStarts the capture of the card expiration date.\n\nParameters:\n- `callSid`: The Twilio Call SID for the active call\n- `paymentSid`: The Twilio Payment SID for the payment session\n- `captureType`: Set to 'expiration-date'\n\nReturns:\n- Status of the expiration date capture operation\n\n### completePaymentCapture\n\nCompletes a payment capture session.\n\nParameters:\n- `callSid`: The Twilio Call SID for the active call\n- `paymentSid`: The Twilio Payment SID for the payment session\n\nReturns:\n- Status of the payment completion operation\n\n## Available Resources\n\n### payment://{callSid}/{paymentSid}/status\n\nGet the current status of a payment session as a JSON object. This resource provides detailed information about the current state of the payment capture process, including:\n\n- Payment SID\n- Payment card number (masked)\n- Payment card type\n- Security code status\n- Expiration date\n- Payment confirmation code\n- Payment result\n- Payment token\n\n## MCP Prompts\n\nThe server provides contextual prompts to guide the LLM through each step of the payment flow:\n\n### StartCapture Prompt\n\nProvides guidance on how to initiate the payment capture process, including:\n- Instructions for asking the customer if they're ready to provide payment information\n- Explanation of the secure processing and tokenization\n- Steps to use the startPaymentCapture tool\n- **IMPORTANT**: Requires the user to enter a Call SID from the MCP Client side, which is a mandatory parameter\n\n### CardNumber Prompt\n\nGuides the LLM on how to handle the card number capture process, including:\n- Instructions for explaining to the customer what information is needed\n- Tips for handling customer questions or concerns\n- Steps to use the captureCardNumber tool\n\n### SecurityCode Prompt\n\nProvides guidance on capturing the card security code, including:\n- Instructions for explaining what the security code is\n- Tips for handling customer questions or concerns\n- Steps to use the captureSecurityCode tool\n\n### ExpirationDate Prompt\n\nGuides the LLM on capturing the card expiration date, including:\n- Instructions for explaining the format needed (MM/YY)\n- Tips for handling customer questions or concerns\n- Steps to use the captureExpirationDate tool\n\n### FinishCapture Prompt\n\nProvides guidance on completing the payment capture process, including:\n- Instructions for confirming all information has been collected\n- Steps to use the completePaymentCapture tool\n\n### Completion Prompt\n\nGuides the LLM on what to do after the payment has been successfully processed, including:\n- Instructions for confirming the payment was successful\n- Suggestions for next steps in the conversation\n\n### Error Prompt\n\nProvides guidance on handling errors during the payment capture process, including:\n- Instructions for explaining the error to the customer\n- Suggestions for troubleshooting common issues\n- Steps to retry the payment capture process\n\n## Architecture\n\nThis MCP server implements an enhanced architecture for handling payment flows:\n\n### Event-Based Architecture\n\nThe server uses an event-based architecture with EventEmitter for communication between components:\n- Each tool, resource, and server component extends EventEmitter\n- Components emit events for logging and callbacks\n- Event listeners forward logs to the MCP server's logging system\n\n### Callback Handling\n\nThe server uses the @deshartman/mcp-status-callback package to handle asynchronous callbacks from Twilio:\n- Creates a secure tunnel using Ngrok for receiving callbacks\n- Processes callbacks for different payment stages\n- Updates the state store based on callback data\n- Handles error conditions and re-entry scenarios\n\n### State Management\n\nPayment state is managed through a Map-based store:\n- The statusCallbackMap stores payment session data indexed by payment SID\n- Each callback updates the state with the latest information\n- The PaymentStatusResource provides access to this state data\n\n### MCP Integration\n\nThe server integrates with the MCP protocol through:\n- Tools: Defined with Zod schemas for input validation\n- Resources: Providing access to payment state data\n- Prompts: Contextual guidance for each step of the payment flow\n- Logging: Event-based logging forwarded to the MCP server\n\n## Development\n\nTo build the project:\n\n```bash\nnpm install\nnpm run build\n```\n\n### Prerequisites\n\n- Node.js 18+\n- Express (for callback handling)\n- Twilio SDK\n- Ngrok account with auth token\n\n### Running the Server Manually\n\nTo start the server manually for testing (outside of Claude Desktop):\n\n```bash\n# Run with actual credentials\nnode build/index.js \"your_account_sid_here\" \"your_api_key_here\" \"your_api_secret\"\n\n# Or use the npm script (which uses ts-node for development)\nnpm run dev -- \"your_account_sid_here\" \"your_api_key_here\" \"your_api_secret\"\n```\n\nThe server will start and wait for MCP client connections.\n\nWhen using with Claude Desktop, the server is started automatically when Claude loads the configuration file. You don't need to manually start it.\n\n## PCI Compliance\n\nThis server helps with PCI compliance by tokenizing payment card information. The actual card data is handled by Twilio and never stored in your system. For more information on Twilio's PCI compliance, see the [Twilio documentation on secure payments](https://www.twilio.com/docs/voice/tutorials/secure-payment-processing).\n\n## License\n\nMIT\n\n## MCP Inspector Compatibility\n\nWhen using this server with the MCP Inspector, note that all logging is done via the MCP logging capability instead of `console.log()`. This is intentional and necessary for compatibility with the MCP protocol, which uses stdout for JSON communication.\n\nIf you're extending this server or debugging issues:\n\n1. Use the event-based logging system by emitting LOG_EVENT events\n2. Avoid using `console.log()` as it will interfere with the MCP protocol's JSON messages on stdout\n3. For debugging outside the MCP context, you can use `console.error()` which outputs to stderr\n\n## Event-Based Logging Architecture\n\nThe server uses an event-based logging architecture:\n\n1. **Event Emitters**: All tool and resource classes extend Node.js's `EventEmitter` and emit 'log' events with level and message data.\n\n2. **Log Forwarding**: These events are captured by event listeners and forwarded to the MCP server's logging system:\n\n ```javascript\n // Set up event listeners for tool logs\n startPaymentCaptureTool.on(LOG_EVENT, logToMcp);\n captureCardNumberTool.on(LOG_EVENT, logToMcp);\n // ... other tools\n ```\n\n3. **MCP Integration**: The `logToMcp` function transforms these events into MCP-compatible log messages:\n\n ```javascript\n const logToMcp = (data: { level: string, message: string }) => {\n // Only use valid log levels: info, error, debug\n // If level is 'warn', treat it as 'info'\n const mcpLevel = data.level === 'warn' ? 'info' : data.level as \"info\" | \"error\" | \"debug\";\n\n // Send the log message to the MCP server's underlying Server instance\n mcpServer.server.sendLoggingMessage({\n level: mcpLevel,\n data: data.message,\n });\n };\n ```\n\n### Supported Log Levels\n\nThe server supports the following log levels:\n\n- `info`: General information messages\n- `error`: Error messages and exceptions\n- `debug`: Detailed debugging information\n- `warn`: Warning messages (automatically converted to 'info' for MCP compatibility)\n\n## Payment Callback Data Structure\n\nThe server processes two main types of callback data from Twilio:\n\n### Initial Connector Data\n\nWhen a payment session is first created, Twilio sends connector data:\n\n```json\n{\n \"PaymentConnector\": \"PGP_MOCK\",\n \"DateCreated\": \"2021-08-10T03:55:53.408Z\",\n \"PaymentMethod\": \"credit-card\",\n \"CallSid\": \"CAzzzzz\",\n \"ChargeAmount\": \"9.99\",\n \"AccountSid\": \"ACxxxxx\",\n \"Sid\": \"PKxxxx\"\n}\n```\n\n\n\n### Capture Data\n\nAs payment information is captured, Twilio sends updated data:\n\n```json\n{ \n \"SecurityCode\": \"xxx\",\n \"PaymentCardType\": \"visa\",\n \"Sid\": \"PKxxxx\",\n \"PaymentConfirmationCode\": \"ch_a9dc6297cd1a4fb095e61b1a9cf2dd1d\",\n \"CallSid\": \"CAxxxxx\",\n \"Result\": \"success\",\n \"AccountSid\": \"AC75xxxxxx\",\n \"ProfileId\": \"\",\n \"DateUpdated\": \"2021-08-10T03:58:27.290Z\",\n \"PaymentToken\": \"\",\n \"PaymentMethod\": \"credit-card\",\n \"PaymentCardNumber\": \"xxxxxxxxxxxx1111\",\n \"ExpirationDate\": \"1225\"\n}\n```\n\nThe server stores this data in the statusCallbackMap, indexed by the payment SID, and makes it available through the PaymentStatusResource.\n","English","tag","en-US",{"_29":41,"_33":45,"_38":46},{"_31":42,"_33":43,"_35":44},"Un servidor MCP que permite el procesamiento de pagos seguro y compatible con PCI durante llamadas de voz a través de la API de Twilio, proporcionando devoluciones de llamadas asincrónicas y un flujo de trabajo guiado para pagos asistidos por agente.","Servidor MCP de pagos del agente Twilio","# Servidor MCP de pagos del agente Twilio\n\nUn servidor MCP (Protocolo de contexto de modelo) que permite gestionar pagos asistidos por agente a través de la API de Twilio, con funciones mejoradas para devoluciones de llamadas asincrónicas y flujo de trabajo guiado a través de indicaciones contextuales.\n\n## Características\n\n* Procesa pagos seguros durante llamadas de voz a través de Twilio\n* Capturar información de pago (número de tarjeta, código de seguridad, fecha de vencimiento)\n* Tokenizar la información de pago para el cumplimiento de PCI\n* Devoluciones de llamadas asincrónicas a través de recursos MCP\n* Flujo de trabajo guiado con indicaciones de MCP para cada paso del proceso de pago\n* Soporte para reingreso de información de pago\n* Se integra con clientes MCP como Claude Desktop\n* Manejo seguro de credenciales\n* Utiliza claves API de Twilio para mejorar la seguridad\n* Arquitectura de registro basada en eventos\n\n## Instalación\n\nPuedes utilizar este servidor directamente a través de npx:\n\n```bash\nnpx twilio-agent-payments-mcp-server \n```\n\nO instálelo globalmente:\n\n```bash\nnpm install -g twilio-agent-payments-mcp-server\ntwilio-agent-payments-mcp-server \n```\n\n### Parámetros ambientales\n\nAl instalar el servidor, debe proporcionar los siguientes parámetros:\n\n1. **Argumentos de la línea de comandos** (obligatorios):\n\n * `accountSid` : SID de su cuenta de Twilio\n * `apiKey` : Su clave API de Twilio\n * `apiSecret` : Tu secreto de API de Twilio\n\n2. **Variables de entorno** (establecidas antes de ejecutar el servidor):\n\n * `TOKEN_TYPE` : Tipo de token a utilizar para pagos (por ejemplo, 'reutilizable', 'de un solo uso')\n * `CURRENCY` : Moneda para pagos (por ejemplo, 'USD', 'EUR')\n * `PAYMENT_CONNECTOR` : Conector de pago para usar con Twilio\n * `NGROK_AUTH_TOKEN` : Su token de autenticación de Ngrok (necesario para el manejo de devoluciones de llamadas)\n * `NGROK_CUSTOM_DOMAIN` : Dominio personalizado opcional para Ngrok\n\nEjemplo con variables de entorno:\n\n```bash\nTOKEN_TYPE=reusable CURRENCY=USD PAYMENT_CONNECTOR=your_connector NGROK_AUTH_TOKEN=your_token npx twilio-agent-payments-mcp-server \n```\n\nConsulte la sección Configuración a continuación para obtener más detalles sobre estos parámetros.\n\n## Configuración\n\nEl servidor requiere los siguientes parámetros:\n\n* `accountSid` : Su SID de cuenta de Twilio (debe comenzar con 'AC', se validará)\n* `apiKey` : su clave API de Twilio (comienza con 'SK')\n* `apiSecret` : Tu secreto de API de Twilio\n\n### Variables de entorno\n\nLas siguientes variables de entorno se utilizan para la configuración:\n\n* `TOKEN_TYPE` : Tipo de token a utilizar para pagos (por ejemplo, 'reutilizable', 'de un solo uso')\n* `CURRENCY` : Moneda para pagos (por ejemplo, 'USD', 'EUR')\n* `PAYMENT_CONNECTOR` : Conector de pago para usar con Twilio\n* `NGROK_AUTH_TOKEN` : Su token de autenticación de Ngrok (necesario para el manejo de devoluciones de llamadas)\n* `NGROK_CUSTOM_DOMAIN` : Dominio personalizado opcional para Ngrok\n\nNota: Las credenciales de Twilio (accountSid, apiKey, apiSecret) se proporcionan como argumentos de la línea de comandos, no como variables de entorno.\n\n### Nota de seguridad\n\nEste servidor utiliza claves API y secretos en lugar de tokens de autenticación para mejorar la seguridad. Este enfoque proporciona un mejor control de acceso y la posibilidad de revocar credenciales si es necesario. Para más información, consulte la [documentación sobre claves API de Twilio](https://www.twilio.com/docs/usage/requests-to-twilio) .\n\n## Uso con Claude Desktop\n\n### Desarrollo local\n\nPara el desarrollo local (cuando el paquete no está publicado en npm), agregue lo siguiente a su archivo de configuración de Claude Desktop ( `~/Library/Application Support/Claude/claude_desktop_config.json` en macOS o `%APPDATA%\\Claude\\claude_desktop_config.json` en Windows):\n\n```json\n{\n \"mcpServers\": {\n \"twilio-agent-payments\": {\n \"command\": \"node\",\n \"args\": [\n \"/PATHTONODE/twilio-agent-payments-mcp-server/build/index.js\",\n \"your_account_sid_here\",\n \"your_api_key_here\",\n \"your_api_secret_here\"\n ],\n \"env\": {\n \"TOKEN_TYPE\": \"reusable\",\n \"CURRENCY\": \"USD\",\n \"PAYMENT_CONNECTOR\": \"your_connector_name\",\n \"NGROK_AUTH_TOKEN\": \"your_ngrok_auth_token_here\",\n \"NGROK_CUSTOM_DOMAIN\": \"your_custom_domain_here\" // Optional\n }\n }\n }\n}\n```\n\nReemplace los valores con sus credenciales y configuración reales de Twilio.\n\n### Después de publicar en npm\n\nUna vez que el paquete se publica en npm, puedes usar la siguiente configuración:\n\n```json\n{\n \"mcpServers\": {\n \"twilio-agent-payments\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\", \n \"twilio-agent-payments-mcp-server\",\n \"your_account_sid_here\",\n \"your_api_key_here\",\n \"your_api_secret_here\"\n ],\n \"env\": {\n ...process.env, // Include existing environment variables so child process has access to the path\n \"TOKEN_TYPE\": \"reusable\",\n \"CURRENCY\": \"USD\",\n \"PAYMENT_CONNECTOR\": \"your_connector_name\",\n \"NGROK_AUTH_TOKEN\": \"your_ngrok_auth_token_here\",\n \"NGROK_CUSTOM_DOMAIN\": \"your_custom_domain_here\" // Optional\n }\n }\n }\n}\n```\n\n## Integración con aplicaciones host\n\nUna de las principales ventajas del Protocolo de Contexto de Modelo (MCP) es que elimina la necesidad de una extensa configuración manual del contexto LLM. El servidor MCP proporciona automáticamente todas las definiciones de herramientas, plantillas de recursos y capacidades necesarias al cliente LLM.\n\n### Configuración de su aplicación host\n\nPara integrar este servidor MCP en su propia aplicación host:\n\n1. **Implementar un cliente MCP** : utilice una biblioteca de cliente MCP existente o implemente el protocolo de cliente MCP en su aplicación.\n\n2. **Conectarse al servidor MCP** : configure su aplicación para conectarse al servidor MCP de Twilio Agent Payments.\n\n3. **Deje que el protocolo se encargue del resto** : el servidor MCP automáticamente:\n\n * Registra sus herramientas y recursos con su cliente\n * Proporcionar esquemas de entrada para todas las herramientas\n * Proporcionar indicaciones contextuales para guiar al LLM a través del flujo de pago\n\nNo se requiere una definición manual de herramientas o recursos en el contexto de su LLM: el protocolo MCP maneja este descubrimiento automáticamente.\n\n### Código de integración de ejemplo\n\nA continuación se muestra un ejemplo simplificado de cómo integrarse con un cliente MCP:\n\n```javascript\n// Initialize your MCP client\nconst mcpClient = new McpClient();\n\n// Connect to the Twilio Agent Payments MCP server\nawait mcpClient.connectToServer({\n name: \"twilio-agent-payments\",\n // Connection details depend on your specific MCP client implementation\n // This could be a WebSocket URL, stdio connection, or other transport\n});\n\n// The client will automatically discover available tools and resources\n\n// When the LLM wants to use a tool, your application can handle it like this:\nfunction handleLlmToolRequest(toolRequest) {\n // The toolRequest would contain:\n // - server_name: \"twilio-agent-payments\"\n // - tool_name: e.g., \"startPaymentCapture\"\n // - arguments: e.g., { callSid: \"CA1234567890abcdef\" }\n \n return mcpClient.callTool(toolRequest);\n}\n\n// Similarly for resources:\nfunction handleLlmResourceRequest(resourceRequest) {\n // The resourceRequest would contain:\n // - server_name: \"twilio-agent-payments\"\n // - uri: e.g., \"payment://CA1234567890abcdef/PA9876543210abcdef/status\"\n \n return mcpClient.accessResource(resourceRequest);\n}\n```\n\n### Contexto mínimo de LLM requerido\n\nEl LLM solo necesita saber que puede usar el servidor MCP de Twilio Agent Payments para gestionar los pagos. Una simple instrucción en el indicador del sistema es suficiente:\n\n```\nYou have access to a Twilio Agent Payments MCP server that can help process secure payments during voice calls. \nWhen a customer wants to make a payment, you can use the tools provided by this server to securely capture \npayment information while maintaining PCI compliance.\n\nThe server will guide you through the payment process with contextual prompts at each step.\n```\n\nEl propio servidor MCP proporciona todas las definiciones detalladas de herramientas, esquemas de entrada y indicaciones contextuales para guiar al LLM a través del flujo de pago.\n\n## Notas de implementación para desarrolladores\n\nEsta sección explica cómo se organiza la implementación del servidor MCP en diferentes componentes y archivos, centrándose en los patrones de arquitectura utilizados.\n\n### Organización de componentes\n\nLa implementación del servidor se divide en varios directorios:\n\n1. **src/index.ts** : El punto de entrada principal que:\n\n * Inicializa el servidor MCP\n * Inicializa el singleton TwilioAgentPaymentServer\n * Descubre y registra todos los componentes con el servidor MCP mediante descubrimiento automático\n * Configura oyentes de eventos para el registro\n * Conecta el servidor a la capa de transporte\n\n2. **src/tools/** : Contiene implementaciones de herramientas individuales\n\n * Cada herramienta se implementa como una función de fábrica que devuelve un objeto con nombre, descripción, forma y propiedades de ejecución.\n * Las herramientas manejan operaciones de pago específicas (por ejemplo, StartPaymentCaptureTool, CaptureCardNumberTool)\n * Cada herramienta define su esquema de entrada utilizando Zod e implementa un método de ejecución\n * Las herramientas acceden al singleton TwilioAgentPaymentServer a través de getInstance()\n\n3. **src/prompts/** : Contiene implementaciones de indicaciones\n\n * Cada solicitud se implementa como una función de fábrica que devuelve un objeto con nombre, descripción y propiedades de ejecución.\n * Las indicaciones brindan orientación contextual al LLM para cada paso del flujo de pago.\n * Algunas indicaciones aceptan parámetros que pueden usarse para personalizar el contenido de la indicación.\n\n4. **src/resources/** : Contiene implementaciones de recursos\n\n * Los recursos proporcionan acceso a los datos (por ejemplo, PaymentStatusResource)\n * Cada recurso se implementa como una función de fábrica que devuelve un objeto con nombre, plantilla, descripción y propiedades de lectura.\n * Los recursos acceden al singleton TwilioAgentPaymentServer a través de getInstance()\n\n5. **src/api-servers/** : Contiene la implementación del cliente API de Twilio\n\n * Implementa TwilioAgentPaymentServer como un singleton\n * Maneja la comunicación con la API de Twilio\n * Gestiona el estado de la sesión de pago\n * Proporciona métodos estáticos para acceder a la instancia singleton\n\n6. **src/utils/** : Contiene funciones de utilidad\n\n * El archivo autoDiscovery.ts maneja el descubrimiento y registro automático de herramientas, indicaciones y recursos.\n\n### Patrón Singleton para TwilioAgentPaymentServer\n\nUn patrón arquitectónico clave en esta base de código es el uso del patrón Singleton para TwilioAgentPaymentServer:\n\n```typescript\nclass TwilioAgentPaymentServer extends EventEmitter {\n // Singleton instance\n private static instance: TwilioAgentPaymentServer | null = null;\n\n /**\n * Static method to get the instance\n */\n public static getInstance(): TwilioAgentPaymentServer {\n if (!TwilioAgentPaymentServer.instance) {\n throw new Error('TwilioAgentPaymentServer not initialized. Call initialize() first.');\n }\n return TwilioAgentPaymentServer.instance;\n }\n \n /**\n * Static method to initialize the instance\n */\n public static initialize(accountSid: string, apiKey: string, apiSecret: string): TwilioAgentPaymentServer {\n if (!TwilioAgentPaymentServer.instance) {\n TwilioAgentPaymentServer.instance = new TwilioAgentPaymentServer(accountSid, apiKey, apiSecret);\n }\n return TwilioAgentPaymentServer.instance;\n }\n\n // Private constructor to prevent direct instantiation\n private constructor(accountSid: string, apiKey: string, apiSecret: string) {\n // Initialization code...\n }\n}\n```\n\nBeneficios de este enfoque:\n\n* Garantiza que solo haya una instancia de TwilioAgentPaymentServer en toda la aplicación\n* Elimina la necesidad de pasar la instancia a través de múltiples funciones\n* Proporciona una API más limpia con firmas de funciones más simples\n* Facilita el acceso a TwilioAgentPaymentServer desde cualquier lugar del código base\n\n### Patrón de función de fábrica\n\nLas herramientas, indicaciones y recursos se implementan utilizando el patrón de función de fábrica:\n\n1. **En Herramientas** :\n\n ```typescript\n // Example from StartPaymentCaptureTool.ts\n export function startPaymentCaptureTool() {\n // Get the TwilioAgentPaymentServer instance\n const twilioAgentPaymentServer = TwilioAgentPaymentServer.getInstance();\n \n // Create an event emitter for logging\n const emitter = new EventEmitter();\n \n return {\n name: \"startPaymentCapture\",\n description: \"Start a new payment capture session\",\n shape: schema.shape,\n execute: async function execute(params: z.infer, extra: any): Promise {\n // Implementation that calls Twilio API and returns result\n },\n emitter // For attaching event listeners\n }\n }\n ```\n\n2. **En Recursos** :\n\n ```typescript\n // Example from PaymentStatusResource.ts\n export function paymentStatusResource() {\n // Get the TwilioAgentPaymentServer instance\n const twilioAgentPaymentServer = TwilioAgentPaymentServer.getInstance();\n \n // Create an event emitter for logging\n const emitter = new EventEmitter();\n \n return {\n name: \"PaymentStatus\",\n template: new ResourceTemplate(\"payment://{callSid}/{paymentSid}/status\", { list: undefined }),\n description: \"Get the current status of a payment session\",\n read: async (uri: URL, variables: Record, extra: any): Promise => {\n // Implementation that retrieves and formats payment status data\n },\n emitter // For attaching event listeners\n };\n }\n ```\n\n3. **En indicaciones** :\n\n ```typescript\n // Example from a prompt factory function\n export function startCapturePrompt() {\n return {\n name: \"StartCapture\",\n description: \"Prompt for starting the payment capture process\",\n execute: (args: { callSid: string }, extra: RequestHandlerExtra): GetPromptResult | Promise => {\n // Return prompt content\n }\n };\n }\n ```\n\n### Descubrimiento automático y registro\n\nEl servidor utiliza un mecanismo de descubrimiento automático para encontrar y registrar todos los componentes:\n\n```typescript\n// In src/utils/autoDiscovery.ts\nexport async function discoverComponents(mcpServer: McpServer) {\n // Get the current directory path\n const basePath: string = path.dirname(fileURLToPath(import.meta.url));\n\n await Promise.all([\n discoverTools(mcpServer, path.join(basePath, '../tools')),\n discoverPrompts(mcpServer, path.join(basePath, '../prompts')),\n discoverResources(mcpServer, path.join(basePath, '../resources'))\n ]);\n}\n```\n\nEste enfoque:\n\n* Encuentra automáticamente todas las herramientas, indicaciones y recursos en sus respectivos directorios.\n* Los importa dinámicamente y los registra con el servidor MCP\n* Facilita la adición de nuevos componentes sin modificar el archivo principal\n* Reduce el código repetitivo y mejora la capacidad de mantenimiento\n\n### Parámetros en los avisos\n\nAlgunos avisos aceptan parámetros que permiten personalizar su contenido. StartCapturePrompt es un buen ejemplo:\n\n1. **Definición de parámetros** :\n\n ```typescript\n // In the prompt factory function\n return {\n name: \"StartCapture\",\n description: \"Prompt for starting the payment capture process\",\n schema: { callSid: z.string().describe(\"The Twilio Call SID\") }, // Parameter schema\n execute: (args: { callSid: string }, extra: RequestHandlerExtra) => {\n // Implementation\n }\n };\n ```\n\n * La propiedad de esquema define el parámetro esquema usando Zod\n * En este caso, se requiere un parámetro `callSid` de tipo cadena.\n\n2. **Uso de parámetros en el mensaje** :\n\n ```typescript\n execute: (args: { callSid: string }, extra: RequestHandlerExtra): GetPromptResult | Promise => {\n const { callSid } = args;\n\n if (!callSid) {\n throw new Error(\"callSid parameter is required\");\n }\n \n return {\n messages: [\n {\n role: \"assistant\",\n content: {\n type: \"text\",\n text: getStartCapturePromptText(callSid), // Use the parameter in the prompt text\n }\n }\n ]\n };\n }\n ```\n\n * El método de ejecución acepta los parámetros como su primer argumento.\n * Puede validar los parámetros y usarlos para personalizar el contenido del mensaje.\n * En este caso, callSid se utiliza en el texto del mensaje para proporcionar contexto.\n\nEste patrón permite que los avisos sean dinámicos y contextuales, brindando orientación personalizada según el estado actual del flujo de pago.\n\n## Herramientas disponibles\n\n### iniciarCaptura de Pago\n\nInicia un proceso de captura de pago para una llamada activa.\n\nParámetros:\n\n* `callSid` : El SID de llamada de Twilio para la llamada activa\n\nIMPORTANTE: El archivo StartCapturePrompt.ts requiere que el usuario introduzca un SID de llamada desde el cliente MCP. Este parámetro es obligatorio y, si no se proporciona, el mensaje generará un error.\n\nNOTA: Al gestionar llamadas de Twilio, es necesario comprender con qué segmento de llamada se está trabajando. Los pagos de Twilio deben estar vinculados al segmento de llamada del lado PSTN. Si se aplican al lado del cliente de Twilio, no se capturarán los dígitos DTMF. Por lo tanto, este servidor MCP asume que se está utilizando el segmento de llamada correcto. Normalmente, se verifica como se indica a continuación:\n\n```javascript\n // Pseudo code: direction of the call\n if (event.CallDirection === \"toPSTN\") {\n theCallSid = event.CallSid;\n }\n\n if (event.CallDirection == \"toSIP\") {\n theCallSid = event.ParentCallSid;\n }\n```\n\nDevoluciones:\n\n* `paymentSid` : El SID de pago de Twilio para la nueva sesión de pago\n\n### capturarNúmeroDeTarjeta\n\nInicia la captura del número de tarjeta de pago.\n\nParámetros:\n\n* `callSid` : El SID de llamada de Twilio para la llamada activa\n* `paymentSid` : El SID de pago de Twilio para la sesión de pago\n* `captureType` : Establezca en 'número de tarjeta de pago'\n\nDevoluciones:\n\n* Estado de la operación de captura del número de tarjeta\n\n### capturarCódigoDeSeguridad\n\nInicia la captura del código de seguridad de la tarjeta.\n\nParámetros:\n\n* `callSid` : El SID de llamada de Twilio para la llamada activa\n* `paymentSid` : El SID de pago de Twilio para la sesión de pago\n* `captureType` : Establecido en 'código de seguridad'\n\nDevoluciones:\n\n* Estado de la operación de captura del código de seguridad\n\n### Fecha de caducidad de la captura\n\nInicia la captura de la fecha de vencimiento de la tarjeta.\n\nParámetros:\n\n* `callSid` : El SID de llamada de Twilio para la llamada activa\n* `paymentSid` : El SID de pago de Twilio para la sesión de pago\n* `captureType` : Establecido en 'fecha de caducidad'\n\nDevoluciones:\n\n* Estado de la operación de captura de fecha de vencimiento\n\n### Captura de pago completa\n\nCompleta una sesión de captura de pago.\n\nParámetros:\n\n* `callSid` : El SID de llamada de Twilio para la llamada activa\n* `paymentSid` : El SID de pago de Twilio para la sesión de pago\n\nDevoluciones:\n\n* Estado de la operación de finalización del pago\n\n## Recursos disponibles\n\n### pago://{callSid}/{paymentSid}/estado\n\nObtenga el estado actual de una sesión de pago como un objeto JSON. Este recurso proporciona información detallada sobre el estado actual del proceso de captura de pagos, incluyendo:\n\n* SID de pago\n* Número de tarjeta de pago (enmascarado)\n* Tipo de tarjeta de pago\n* Estado del código de seguridad\n* Fecha de expiración\n* Código de confirmación de pago\n* Resultado del pago\n* Token de pago\n\n## Indicaciones de MCP\n\nEl servidor proporciona indicaciones contextuales para guiar al LLM a través de cada paso del flujo de pago:\n\n### Indicador de inicio de captura\n\nProporciona orientación sobre cómo iniciar el proceso de captura de pagos, incluyendo:\n\n* Instrucciones para preguntar al cliente si está listo para proporcionar información de pago\n* Explicación del procesamiento seguro y tokenización\n* Pasos para utilizar la herramienta startPaymentCapture\n* **IMPORTANTE** : Requiere que el usuario ingrese un SID de llamada desde el lado del cliente MCP, que es un parámetro obligatorio\n\n### Solicitud de número de tarjeta\n\nOrienta al LLM sobre cómo manejar el proceso de captura de números de tarjeta, incluyendo:\n\n* Instrucciones para explicar al cliente qué información necesita\n* Consejos para gestionar las preguntas o inquietudes de los clientes\n* Pasos para utilizar la herramienta captureCardNumber\n\n### Aviso de código de seguridad\n\nProporciona orientación sobre cómo capturar el código de seguridad de la tarjeta, que incluye:\n\n* Instrucciones para explicar qué es el código de seguridad\n* Consejos para gestionar las preguntas o inquietudes de los clientes\n* Pasos para utilizar la herramienta captureSecurityCode\n\n### Aviso de fecha de vencimiento\n\nOrienta al LLM sobre cómo capturar la fecha de vencimiento de la tarjeta, incluyendo:\n\n* Instrucciones para explicar el formato necesario (MM/AA)\n* Consejos para gestionar las preguntas o inquietudes de los clientes\n* Pasos para utilizar la herramienta captureExpirationDate\n\n### Solicitud de finalización de captura\n\nProporciona orientación sobre cómo completar el proceso de captura de pagos, que incluye:\n\n* Instrucciones para confirmar que se ha recopilado toda la información\n* Pasos para utilizar la herramienta completePaymentCapture\n\n### Aviso de finalización\n\nOrienta al LLM sobre qué hacer después de que el pago se haya procesado exitosamente, incluyendo:\n\n* Instrucciones para confirmar que el pago fue exitoso\n* Sugerencias para los próximos pasos en la conversación\n\n### Mensaje de error\n\nProporciona orientación sobre el manejo de errores durante el proceso de captura de pagos, incluyendo:\n\n* Instrucciones para explicar el error al cliente\n* Sugerencias para solucionar problemas comunes\n* Pasos para reintentar el proceso de captura de pago\n\n## Arquitectura\n\nEste servidor MCP implementa una arquitectura mejorada para gestionar los flujos de pago:\n\n### Arquitectura basada en eventos\n\nEl servidor utiliza una arquitectura basada en eventos con EventEmitter para la comunicación entre componentes:\n\n* Cada herramienta, recurso y componente de servidor extiende EventEmitter\n* Los componentes emiten eventos para registro y devoluciones de llamadas\n* Los oyentes de eventos reenvían registros al sistema de registro del servidor MCP\n\n### Manejo de devoluciones de llamadas\n\nEl servidor utiliza el paquete @deshartman/mcp-status-callback para manejar devoluciones de llamadas asincrónicas de Twilio:\n\n* Crea un túnel seguro usando Ngrok para recibir devoluciones de llamadas\n* Procesa devoluciones de llamadas para diferentes etapas de pago\n* Actualiza el almacén de estados en función de los datos de devolución de llamada\n* Maneja condiciones de error y escenarios de reingreso\n\n### Gestión del Estado\n\nEl estado del pago se gestiona a través de una tienda basada en mapas:\n\n* El statusCallbackMap almacena datos de la sesión de pago indexados por SID de pago\n* Cada devolución de llamada actualiza el estado con la información más reciente\n* PaymentStatusResource proporciona acceso a estos datos de estado\n\n### Integración MCP\n\nEl servidor se integra con el protocolo MCP a través de:\n\n* Herramientas: definidas con esquemas Zod para la validación de entrada\n* Recursos: Proporcionar acceso a los datos del estado de pago\n* Indicaciones: Orientación contextual para cada paso del flujo de pago\n* Registro: registro basado en eventos reenviado al servidor MCP\n\n## Desarrollo\n\nPara construir el proyecto:\n\n```bash\nnpm install\nnpm run build\n```\n\n### Prerrequisitos\n\n* Node.js 18+\n* Express (para el manejo de devoluciones de llamadas)\n* Kit de desarrollo de software de Twilio\n* Cuenta de Ngrok con token de autorización\n\n### Ejecutar el servidor manualmente\n\nPara iniciar el servidor manualmente para realizar pruebas (fuera de Claude Desktop):\n\n```bash\n# Run with actual credentials\nnode build/index.js \"your_account_sid_here\" \"your_api_key_here\" \"your_api_secret\"\n\n# Or use the npm script (which uses ts-node for development)\nnpm run dev -- \"your_account_sid_here\" \"your_api_key_here\" \"your_api_secret\"\n```\n\nEl servidor se iniciará y esperará conexiones de cliente MCP.\n\nAl usar Claude Desktop, el servidor se inicia automáticamente cuando Claude carga el archivo de configuración. No es necesario iniciarlo manualmente.\n\n## Cumplimiento de PCI\n\nEste servidor facilita el cumplimiento de PCI mediante la tokenización de la información de las tarjetas de pago. Twilio gestiona los datos de la tarjeta y nunca se almacenan en su sistema. Para obtener más información sobre el cumplimiento de PCI de Twilio, consulte la [documentación de Twilio sobre pagos seguros](https://www.twilio.com/docs/voice/tutorials/secure-payment-processing) .\n\n## Licencia\n\nInstituto Tecnológico de Massachusetts (MIT)\n\n## Compatibilidad del inspector MCP\n\nAl usar este servidor con el Inspector MCP, tenga en cuenta que todo el registro se realiza mediante la función de registro de MCP en lugar de `console.log()` . Esto es intencional y necesario para la compatibilidad con el protocolo MCP, que utiliza la salida estándar para la comunicación JSON.\n\nSi está ampliando este servidor o depurando problemas:\n\n1. Utilice el sistema de registro basado en eventos emitiendo eventos LOG\\_EVENT\n2. Evite usar `console.log()` ya que interferirá con los mensajes JSON del protocolo MCP en la salida estándar\n3. Para depurar fuera del contexto MCP, puede usar `console.error()` que genera un error en stderr.\n\n## Arquitectura de registro basada en eventos\n\nEl servidor utiliza una arquitectura de registro basada en eventos:\n\n1. **Emisores de eventos** : todas las clases de herramientas y recursos extienden `EventEmitter` de Node.js y emiten eventos de 'registro' con datos de nivel y mensaje.\n\n2. **Reenvío de registros** : estos eventos son capturados por los escuchas de eventos y reenviados al sistema de registro del servidor MCP:\n\n ```javascript\n // Set up event listeners for tool logs\n startPaymentCaptureTool.on(LOG_EVENT, logToMcp);\n captureCardNumberTool.on(LOG_EVENT, logToMcp);\n // ... other tools\n ```\n\n3. **Integración con MCP** : la función `logToMcp` transforma estos eventos en mensajes de registro compatibles con MCP:\n\n ```javascript\n const logToMcp = (data: { level: string, message: string }) => {\n // Only use valid log levels: info, error, debug\n // If level is 'warn', treat it as 'info'\n const mcpLevel = data.level === 'warn' ? 'info' : data.level as \"info\" | \"error\" | \"debug\";\n\n // Send the log message to the MCP server's underlying Server instance\n mcpServer.server.sendLoggingMessage({\n level: mcpLevel,\n data: data.message,\n });\n };\n ```\n\n### Niveles de registro admitidos\n\nEl servidor admite los siguientes niveles de registro:\n\n* `info` : Mensajes de información general\n* `error` : Mensajes de error y excepciones\n* `debug` : información de depuración detallada\n* `warn` : Mensajes de advertencia (convertidos automáticamente a 'info' para compatibilidad con MCP)\n\n## Estructura de datos de devolución de llamada de pago\n\nEl servidor procesa dos tipos principales de datos de devolución de llamada de Twilio:\n\n### Datos iniciales del conector\n\nCuando se crea por primera vez una sesión de pago, Twilio envía datos del conector:\n\n```json\n{\n \"PaymentConnector\": \"PGP_MOCK\",\n \"DateCreated\": \"2021-08-10T03:55:53.408Z\",\n \"PaymentMethod\": \"credit-card\",\n \"CallSid\": \"CAzzzzz\",\n \"ChargeAmount\": \"9.99\",\n \"AccountSid\": \"ACxxxxx\",\n \"Sid\": \"PKxxxx\"\n}\n```\n\n### Capturar datos\n\nA medida que se captura la información de pago, Twilio envía datos actualizados:\n\n```json\n{ \n \"SecurityCode\": \"xxx\",\n \"PaymentCardType\": \"visa\",\n \"Sid\": \"PKxxxx\",\n \"PaymentConfirmationCode\": \"ch_a9dc6297cd1a4fb095e61b1a9cf2dd1d\",\n \"CallSid\": \"CAxxxxx\",\n \"Result\": \"success\",\n \"AccountSid\": \"AC75xxxxxx\",\n \"ProfileId\": \"\",\n \"DateUpdated\": \"2021-08-10T03:58:27.290Z\",\n \"PaymentToken\": \"\",\n \"PaymentMethod\": \"credit-card\",\n \"PaymentCardNumber\": \"xxxxxxxxxxxx1111\",\n \"ExpirationDate\": \"1225\"\n}\n```\n\nEl servidor almacena estos datos en el statusCallbackMap, indexado por el SID de pago, y los pone a disposición a través de PaymentStatusResource.","Spanish","es-ES",{"_29":48,"_33":52,"_38":53},{"_31":49,"_33":50,"_35":51},"Twilio API 経由の音声通話中に安全な PCI 準拠の支払い処理を可能にし、エージェント支援による支払いのための非同期コールバックとガイド付きワークフローを提供する MCP サーバーです。","Twilio エージェント支払い MCP サーバー","# Twilio エージェント支払い MCP サーバー\n\nTwilio API 経由でエージェント支援による支払いを処理できるようにする MCP (Model Context Protocol) サーバー。非同期コールバックの機能が強化され、コンテキストプロンプトによるワークフローのガイドも提供されます。\n\n## 特徴\n\n* Twilio 経由で音声通話中に安全な支払いを処理\n* 支払い情報（カード番号、セキュリティコード、有効期限）を取得します\n* PCIコンプライアンスのために支払い情報をトークン化する\n* MCPリソース経由の非同期コールバック\n* 支払いプロセスの各ステップでMCPプロンプトによるガイド付きワークフロー\n* 支払い情報の再入力のサポート\n* Claude DesktopなどのMCPクライアントと統合\n* 安全な資格情報の取り扱い\n* セキュリティ強化のためTwilio APIキーを使用\n* イベントベースのログ記録アーキテクチャ\n\n## インストール\n\nこのサーバーは npx 経由で直接使用できます。\n\n```bash\nnpx twilio-agent-payments-mcp-server \n```\n\nまたは、グローバルにインストールします。\n\n```bash\nnpm install -g twilio-agent-payments-mcp-server\ntwilio-agent-payments-mcp-server \n```\n\n### 環境パラメータ\n\nサーバーをインストールするときは、次のパラメータを指定する必要があります。\n\n1. **コマンドライン引数**（必須）:\n\n * `accountSid` : Twilio アカウントの SID\n * `apiKey` : Twilio APIキー\n * `apiSecret` : Twilio APIシークレット\n\n2. **環境変数**（サーバーを実行する前に設定）：\n\n * `TOKEN_TYPE` : 支払いに使用するトークンの種類（例：「再利用可能」、「1回限り」）\n * `CURRENCY` : 支払い通貨（例: 'USD'、'EUR'）\n * `PAYMENT_CONNECTOR` : Twilioで使用する支払いコネクタ\n * `NGROK_AUTH_TOKEN` : Ngrok認証トークン（コールバック処理に必要）\n * `NGROK_CUSTOM_DOMAIN` : Ngrok のオプションのカスタムドメイン\n\n環境変数を使用した例:\n\n```bash\nTOKEN_TYPE=reusable CURRENCY=USD PAYMENT_CONNECTOR=your_connector NGROK_AUTH_TOKEN=your_token npx twilio-agent-payments-mcp-server \n```\n\nこれらのパラメータの詳細については、以下の構成セクションを参照してください。\n\n## 構成\n\nサーバーには次のパラメータが必要です。\n\n* `accountSid` : Twilio アカウントの SID (「AC」で始まる必要があり、検証されます)\n* `apiKey` : Twilio API キー ('SK' で始まる)\n* `apiSecret` : Twilio APIシークレット\n\n### 環境変数\n\n構成には次の環境変数が使用されます。\n\n* `TOKEN_TYPE` : 支払いに使用するトークンの種類（例：「再利用可能」、「1回限り」）\n* `CURRENCY` : 支払い通貨（例: 'USD'、'EUR'）\n* `PAYMENT_CONNECTOR` : Twilioで使用する支払いコネクタ\n* `NGROK_AUTH_TOKEN` : Ngrok認証トークン（コールバック処理に必要）\n* `NGROK_CUSTOM_DOMAIN` : Ngrok のオプションのカスタムドメイン\n\n注: Twilio 資格情報 (accountSid、apiKey、apiSecret) は、環境変数ではなく、コマンドライン引数として提供されます。\n\n### セキュリティに関する注意事項\n\nこのサーバーは、セキュリティ強化のため、認証トークンではなくAPIキーとシークレットを使用します。このアプローチにより、アクセス制御が向上し、必要に応じて認証情報を失効させることができます。詳細については、 [Twilio APIキーのドキュメント](https://www.twilio.com/docs/usage/requests-to-twilio)をご覧ください。\n\n## Claude Desktopでの使用\n\n### 地域開発\n\nローカル開発の場合 (パッケージが npm に公開されていない場合)、Claude Desktop 構成ファイル (macOS の場合は`~/Library/Application Support/Claude/claude_desktop_config.json` 、Windows の場合は`%APPDATA%\\Claude\\claude_desktop_config.json` ) に以下を追加します。\n\n```json\n{\n \"mcpServers\": {\n \"twilio-agent-payments\": {\n \"command\": \"node\",\n \"args\": [\n \"/PATHTONODE/twilio-agent-payments-mcp-server/build/index.js\",\n \"your_account_sid_here\",\n \"your_api_key_here\",\n \"your_api_secret_here\"\n ],\n \"env\": {\n \"TOKEN_TYPE\": \"reusable\",\n \"CURRENCY\": \"USD\",\n \"PAYMENT_CONNECTOR\": \"your_connector_name\",\n \"NGROK_AUTH_TOKEN\": \"your_ngrok_auth_token_here\",\n \"NGROK_CUSTOM_DOMAIN\": \"your_custom_domain_here\" // Optional\n }\n }\n }\n}\n```\n\n値を実際の Twilio の資格情報と設定に置き換えます。\n\n### npmに公開した後\n\nパッケージが npm に公開されると、次の構成を使用できます。\n\n```json\n{\n \"mcpServers\": {\n \"twilio-agent-payments\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\", \n \"twilio-agent-payments-mcp-server\",\n \"your_account_sid_here\",\n \"your_api_key_here\",\n \"your_api_secret_here\"\n ],\n \"env\": {\n ...process.env, // Include existing environment variables so child process has access to the path\n \"TOKEN_TYPE\": \"reusable\",\n \"CURRENCY\": \"USD\",\n \"PAYMENT_CONNECTOR\": \"your_connector_name\",\n \"NGROK_AUTH_TOKEN\": \"your_ngrok_auth_token_here\",\n \"NGROK_CUSTOM_DOMAIN\": \"your_custom_domain_here\" // Optional\n }\n }\n }\n}\n```\n\n## ホストアプリケーションとの統合\n\nモデルコンテキストプロトコル（MCP）の主な利点の一つは、LLMコンテキストの詳細な手動設定が不要になることです。MCPサーバーは、LLMクライアントに必要なすべてのツール定義、リソーステンプレート、および機能を自動的に提供します。\n\n### ホストアプリケーションの設定\n\nこの MCP サーバーを独自のホストアプリケーションに統合するには:\n\n1. **MCP クライアントを実装する**: 既存の MCP クライアントライブラリを使用するか、アプリケーションに MCP クライアントプロトコルを実装します。\n\n2. **MCP サーバーに接続**: Twilio Agent Payments MCP サーバーに接続するようにアプリケーションを構成します。\n\n3. **残りはプロトコルに任せましょう**: MCP サーバーは自動的に次の処理を行います。\n\n * ツールとリソースをクライアントに登録する\n * すべてのツールに入力スキーマを提供する\n * 支払いフローを通じて LLM をガイドするためのコンテキストプロンプトを提供する\n\nLLM のコンテキストではツールやリソースを手動で定義する必要はありません。MCP プロトコルがこの検出を自動的に処理します。\n\n### 統合コードの例\n\nMCP クライアントと統合する方法の簡略化された例を次に示します。\n\n```javascript\n// Initialize your MCP client\nconst mcpClient = new McpClient();\n\n// Connect to the Twilio Agent Payments MCP server\nawait mcpClient.connectToServer({\n name: \"twilio-agent-payments\",\n // Connection details depend on your specific MCP client implementation\n // This could be a WebSocket URL, stdio connection, or other transport\n});\n\n// The client will automatically discover available tools and resources\n\n// When the LLM wants to use a tool, your application can handle it like this:\nfunction handleLlmToolRequest(toolRequest) {\n // The toolRequest would contain:\n // - server_name: \"twilio-agent-payments\"\n // - tool_name: e.g., \"startPaymentCapture\"\n // - arguments: e.g., { callSid: \"CA1234567890abcdef\" }\n \n return mcpClient.callTool(toolRequest);\n}\n\n// Similarly for resources:\nfunction handleLlmResourceRequest(resourceRequest) {\n // The resourceRequest would contain:\n // - server_name: \"twilio-agent-payments\"\n // - uri: e.g., \"payment://CA1234567890abcdef/PA9876543210abcdef/status\"\n \n return mcpClient.accessResource(resourceRequest);\n}\n```\n\n### 最小限のLLMコンテキストが必要\n\nLLMは、支払い処理にTwilio Agent Payments MCPサーバーを使用できることを認識するだけで済みます。システムプロンプトに簡単な指示を入力するだけで十分です。\n\n```\nYou have access to a Twilio Agent Payments MCP server that can help process secure payments during voice calls. \nWhen a customer wants to make a payment, you can use the tools provided by this server to securely capture \npayment information while maintaining PCI compliance.\n\nThe server will guide you through the payment process with contextual prompts at each step.\n```\n\nMCP サーバー自体は、支払いフローを通じて LLM をガイドするための詳細なツール定義、入力スキーマ、およびコンテキストプロンプトをすべて提供します。\n\n## 開発者実装ノート\n\nこのセクションでは、使用されるアーキテクチャパターンに焦点を当てて、MCP サーバーの実装がさまざまなコンポーネントとファイルにわたってどのように構成されているかについて説明します。\n\n### コンポーネントの構成\n\nサーバーの実装は複数のディレクトリに分割されています。\n\n1. **src/index.ts** : 次のメインエントリポイント:\n\n * MCPサーバーを初期化します\n * TwilioAgentPaymentServerシングルトンを初期化します\n * 自動検出により、すべてのコンポーネントをMCPサーバーで検出して登録します。\n * ログ記録用のイベントリスナーを設定する\n * サーバーをトランスポート層に接続する\n\n2. **src/tools/** : 個々のツールの実装が含まれています\n\n * 各ツールは、名前、説明、形状、実行プロパティを持つオブジェクトを返すファクトリー関数として実装されています。\n * ツールは特定の支払い操作を処理します（例：StartPaymentCaptureTool、CaptureCardNumberTool）\n * 各ツールはZodを使用して入力スキーマを定義し、実行メソッドを実装します。\n * ツールは getInstance() を介して TwilioAgentPaymentServer シングルトンにアクセスします。\n\n3. **src/prompts/** : プロンプトの実装が含まれています\n\n * 各プロンプトは、名前、説明、実行プロパティを持つオブジェクトを返すファクトリー関数として実装されています。\n * プロンプトは、支払いフローの各ステップについて LLM に状況に応じたガイダンスを提供します。\n * 一部のプロンプトは、プロンプトの内容をカスタマイズするために使用できるパラメータを受け入れます。\n\n4. **src/resources/** : リソース実装が含まれています\n\n * リソースはデータへのアクセスを提供します（例：PaymentStatusResource）\n * 各リソースは、名前、テンプレート、説明、読み取りプロパティを持つオブジェクトを返すファクトリー関数として実装されています。\n * リソースは getInstance() を介して TwilioAgentPaymentServer シングルトンにアクセスします。\n\n5. **src/api-servers/** : Twilio APIクライアントの実装が含まれています\n\n * TwilioAgentPaymentServerをシングルトンとして実装する\n * Twilio APIとの通信を処理します\n * 支払いセッションの状態を管理する\n * シングルトンインスタンスにアクセスするための静的メソッドを提供します\n\n6. **src/utils/** : ユーティリティ関数が含まれています\n\n * autoDiscovery.tsファイルは、ツール、プロンプト、リソースの自動検出と登録を処理します。\n\n### TwilioAgentPaymentServer のシングルトンパターン\n\nこのコードベースの重要なアーキテクチャパターンは、TwilioAgentPaymentServer のシングルトンパターンの使用です。\n\n```typescript\nclass TwilioAgentPaymentServer extends EventEmitter {\n // Singleton instance\n private static instance: TwilioAgentPaymentServer | null = null;\n\n /**\n * Static method to get the instance\n */\n public static getInstance(): TwilioAgentPaymentServer {\n if (!TwilioAgentPaymentServer.instance) {\n throw new Error('TwilioAgentPaymentServer not initialized. Call initialize() first.');\n }\n return TwilioAgentPaymentServer.instance;\n }\n \n /**\n * Static method to initialize the instance\n */\n public static initialize(accountSid: string, apiKey: string, apiSecret: string): TwilioAgentPaymentServer {\n if (!TwilioAgentPaymentServer.instance) {\n TwilioAgentPaymentServer.instance = new TwilioAgentPaymentServer(accountSid, apiKey, apiSecret);\n }\n return TwilioAgentPaymentServer.instance;\n }\n\n // Private constructor to prevent direct instantiation\n private constructor(accountSid: string, apiKey: string, apiSecret: string) {\n // Initialization code...\n }\n}\n```\n\nこのアプローチの利点:\n\n* アプリケーション全体でTwilioAgentPaymentServerのインスタンスが1つだけであることを保証します\n* インスタンスを複数の関数に渡す必要がなくなります\n* よりシンプルな関数シグネチャでよりクリーンなAPIを提供します\n* コードベースのどこからでもTwilioAgentPaymentServerにアクセスしやすくなります\n\n### ファクトリー関数パターン\n\nツール、プロンプト、リソースは、ファクトリ関数パターンを使用して実装されます。\n\n1. **ツール内**:\n\n ```typescript\n // Example from StartPaymentCaptureTool.ts\n export function startPaymentCaptureTool() {\n // Get the TwilioAgentPaymentServer instance\n const twilioAgentPaymentServer = TwilioAgentPaymentServer.getInstance();\n \n // Create an event emitter for logging\n const emitter = new EventEmitter();\n \n return {\n name: \"startPaymentCapture\",\n description: \"Start a new payment capture session\",\n shape: schema.shape,\n execute: async function execute(params: z.infer, extra: any): Promise {\n // Implementation that calls Twilio API and returns result\n },\n emitter // For attaching event listeners\n }\n }\n ```\n\n2. **リソース**:\n\n ```typescript\n // Example from PaymentStatusResource.ts\n export function paymentStatusResource() {\n // Get the TwilioAgentPaymentServer instance\n const twilioAgentPaymentServer = TwilioAgentPaymentServer.getInstance();\n \n // Create an event emitter for logging\n const emitter = new EventEmitter();\n \n return {\n name: \"PaymentStatus\",\n template: new ResourceTemplate(\"payment://{callSid}/{paymentSid}/status\", { list: undefined }),\n description: \"Get the current status of a payment session\",\n read: async (uri: URL, variables: Record, extra: any): Promise => {\n // Implementation that retrieves and formats payment status data\n },\n emitter // For attaching event listeners\n };\n }\n ```\n\n3. **プロンプトの場合**：\n\n ```typescript\n // Example from a prompt factory function\n export function startCapturePrompt() {\n return {\n name: \"StartCapture\",\n description: \"Prompt for starting the payment capture process\",\n execute: (args: { callSid: string }, extra: RequestHandlerExtra): GetPromptResult | Promise => {\n // Return prompt content\n }\n };\n }\n ```\n\n### 自動検出と登録\n\nサーバーは自動検出メカニズムを使用して、すべてのコンポーネントを検索して登録します。\n\n```typescript\n// In src/utils/autoDiscovery.ts\nexport async function discoverComponents(mcpServer: McpServer) {\n // Get the current directory path\n const basePath: string = path.dirname(fileURLToPath(import.meta.url));\n\n await Promise.all([\n discoverTools(mcpServer, path.join(basePath, '../tools')),\n discoverPrompts(mcpServer, path.join(basePath, '../prompts')),\n discoverResources(mcpServer, path.join(basePath, '../resources'))\n ]);\n}\n```\n\nこのアプローチ:\n\n* すべてのツール、プロンプト、リソースをそれぞれのディレクトリ内で自動的に検索します\n* 動的にインポートしてMCPサーバーに登録します\n* メインファイルを変更せずに新しいコンポーネントを簡単に追加できます\n* 定型コードを削減し、保守性を向上させる\n\n### プロンプトのパラメータ\n\n一部のプロンプトは、プロンプトの内容をカスタマイズするためのパラメータを受け入れます。StartCapturePrompt はその良い例です。\n\n1. **パラメータ定義**:\n\n ```typescript\n // In the prompt factory function\n return {\n name: \"StartCapture\",\n description: \"Prompt for starting the payment capture process\",\n schema: { callSid: z.string().describe(\"The Twilio Call SID\") }, // Parameter schema\n execute: (args: { callSid: string }, extra: RequestHandlerExtra) => {\n // Implementation\n }\n };\n ```\n\n * スキーマプロパティは、Zodを使用してパラメータスキーマを定義します。\n * この場合、文字列型の`callSid`パラメータが必要です。\n\n2. **プロンプトでのパラメータの使用**:\n\n ```typescript\n execute: (args: { callSid: string }, extra: RequestHandlerExtra): GetPromptResult | Promise => {\n const { callSid } = args;\n\n if (!callSid) {\n throw new Error(\"callSid parameter is required\");\n }\n \n return {\n messages: [\n {\n role: \"assistant\",\n content: {\n type: \"text\",\n text: getStartCapturePromptText(callSid), // Use the parameter in the prompt text\n }\n }\n ]\n };\n }\n ```\n\n * 実行メソッドは最初の引数としてパラメータを受け取ります\n * パラメータを検証し、それを使用してプロンプトのコンテンツをカスタマイズできます。\n * この場合、callSidはコンテキストを提供するためにプロンプトテキストで使用されます。\n\nこのパターンにより、プロンプトを動的かつ状況に応じて変更し、支払いフローの現在の状態に基づいてカスタマイズされたガイダンスを提供できるようになります。\n\n## 利用可能なツール\n\n### 支払いキャプチャ開始\n\nアクティブな通話の支払いキャプチャプロセスを開始します。\n\nパラメータ:\n\n* `callSid` : アクティブな通話のTwilio通話SID\n\n重要: StartCapturePrompt.ts では、MCP クライアント側からユーザーがコール SID を入力する必要があります。これは必須パラメータであり、入力されていない場合はプロンプトでエラーが発生します。\n\n注: Twilio 通話を処理する際は、どのコールレグ（Call SID）を使用しているかを把握する必要があります。Twilio Payments は PSTN 側のコールレグにアタッチする必要があります。Twilio クライアント側に適用した場合、DTMF 番号はキャプチャされません。そのため、この MCP サーバーは正しいコールレグが使用されていると想定します。通常、以下の手順で確認されます。\n\n```javascript\n // Pseudo code: direction of the call\n if (event.CallDirection === \"toPSTN\") {\n theCallSid = event.CallSid;\n }\n\n if (event.CallDirection == \"toSIP\") {\n theCallSid = event.ParentCallSid;\n }\n```\n\n戻り値:\n\n* `paymentSid` : 新しい支払いセッションのTwilio支払いSID\n\n### キャプチャカード番号\n\n支払いカード番号のキャプチャを開始します。\n\nパラメータ:\n\n* `callSid` : アクティブな通話のTwilio通話SID\n* `paymentSid` : 支払いセッションのTwilio支払いSID\n* `captureType` : 「支払いカード番号」に設定\n\n戻り値:\n\n* カード番号取得操作の状況\n\n### キャプチャセキュリティコード\n\nカードセキュリティコードのキャプチャを開始します。\n\nパラメータ:\n\n* `callSid` : アクティブな通話のTwilio通話SID\n* `paymentSid` : 支払いセッションのTwilio支払いSID\n* `captureType` : 「セキュリティコード」に設定\n\n戻り値:\n\n* セキュリティコードキャプチャ操作のステータス\n\n### キャプチャ有効期限\n\nカード有効期限の取得を開始します。\n\nパラメータ:\n\n* `callSid` : アクティブな通話のTwilio通話SID\n* `paymentSid` : 支払いセッションのTwilio支払いSID\n* `captureType` : 'expiration-date' に設定\n\n戻り値:\n\n* 有効期限取得操作のステータス\n\n### 完全な支払いキャプチャ\n\n支払いキャプチャセッションを完了します。\n\nパラメータ:\n\n* `callSid` : アクティブな通話のTwilio通話SID\n* `paymentSid` : 支払いセッションのTwilio支払いSID\n\n戻り値:\n\n* 支払い完了操作のステータス\n\n## 利用可能なリソース\n\n### 支払い://{callSid}/{paymentSid}/status\n\n決済セッションの現在のステータスをJSONオブジェクトとして取得します。このリソースは、決済キャプチャプロセスの現在の状態に関する詳細な情報を提供します。これには以下が含まれます。\n\n* 支払いSID\n* 支払いカード番号（マスク）\n* 支払いカードの種類\n* セキュリティコードのステータス\n* 有効期限\n* 支払い確認コード\n* 支払い結果\n* 支払いトークン\n\n## MCPプロンプト\n\nサーバーは、支払いフローの各ステップで LLM をガイドするためのコンテキストプロンプトを提供します。\n\n### キャプチャ開始プロンプト\n\n支払いキャプチャプロセスを開始する方法に関するガイダンスを提供します。これには以下が含まれます。\n\n* 顧客に支払い情報を提供する準備ができているかどうかを確認する手順\n* 安全な処理とトークン化の説明\n* startPaymentCaptureツールの使用手順\n* **重要**: ユーザーはMCPクライアント側からコールSIDを入力する必要があります。これは必須パラメータです。\n\n### カード番号プロンプト\n\nLLM にカード番号取得プロセスの処理方法を指導します。これには次の内容が含まれます。\n\n* 顧客に必要な情報を説明する手順\n* 顧客の質問や懸念に対処するためのヒント\n* キャプチャカード番号ツールの使用手順\n\n### セキュリティコードプロンプト\n\nカードセキュリティコードの取得に関する次のようなガイダンスを提供します。\n\n* セキュリティコードの説明\n* 顧客の質問や懸念に対処するためのヒント\n* キャプチャセキュリティコードツールの使用手順\n\n### 有効期限プロンプト\n\nLLM にカードの有効期限の取得について以下のガイドを提供します:\n\n* 必要な形式（MM/YY）の説明手順\n* 顧客の質問や懸念に対処するためのヒント\n* captureExpirationDateツールの使用手順\n\n### キャプチャ完了プロンプト\n\n支払いキャプチャプロセスを完了するためのガイダンスを提供します。これには以下が含まれます。\n\n* すべての情報が収集されたことを確認するための手順\n* completePaymentCaptureツールの使用手順\n\n### 完了プロンプト\n\n支払いが正常に処理された後に行うべきことについて LLM にガイドします。これには次の内容が含まれます。\n\n* 支払いが成功したことを確認するための手順\n* 会話の次のステップの提案\n\n### エラープロンプト\n\n支払いキャプチャプロセス中のエラーの処理に関するガイダンスを提供します。\n\n* 顧客にエラーを説明する手順\n* よくある問題のトラブルシューティングの提案\n* 支払いキャプチャプロセスを再試行する手順\n\n## 建築\n\nこの MCP サーバーは、支払いフローを処理するための強化されたアーキテクチャを実装します。\n\n### イベントベースアーキテクチャ\n\nサーバーは、コンポーネント間の通信に EventEmitter を使用したイベントベースのアーキテクチャを使用します。\n\n* 各ツール、リソース、サーバーコンポーネントはEventEmitterを拡張します\n* コンポーネントはログとコールバックのイベントを発行します\n* イベントリスナーはログをMCPサーバーのログシステムに転送します。\n\n### コールバック処理\n\nサーバーは、@deshartman/mcp-status-callback パッケージを使用して、Twilio からの非同期コールバックを処理します。\n\n* コールバックを受信するためにNgrokを使用して安全なトンネルを作成します\n* さまざまな支払い段階のコールバックを処理します\n* コールバックデータに基づいて状態ストアを更新します\n* エラー状態と再入シナリオを処理する\n\n### 状態管理\n\n支払い状態はマップベースのストアを通じて管理されます。\n\n* statusCallbackMapは支払いSIDでインデックスされた支払いセッションデータを保存します\n* 各コールバックは最新の情報で状態を更新します\n* PaymentStatusResourceはこの状態データへのアクセスを提供します\n\n### MCP統合\n\nサーバーは、次の方法で MCP プロトコルと統合します。\n\n* ツール: 入力検証用の Zod スキーマで定義\n* リソース: 支払い状態データへのアクセスの提供\n* プロンプト: 支払いフローの各ステップのコンテキストガイダンス\n* ログ記録: MCP サーバーに転送されるイベントベースのログ記録\n\n## 発達\n\nプロジェクトをビルドするには:\n\n```bash\nnpm install\nnpm run build\n```\n\n### 前提条件\n\n* Node.js 18歳以上\n* Express（コールバック処理用）\n* Twilio SDK\n* 認証トークンを持つNgrokアカウント\n\n### サーバーを手動で実行する\n\nテストのためにサーバーを手動で起動するには (Claude Desktop の外部):\n\n```bash\n# Run with actual credentials\nnode build/index.js \"your_account_sid_here\" \"your_api_key_here\" \"your_api_secret\"\n\n# Or use the npm script (which uses ts-node for development)\nnpm run dev -- \"your_account_sid_here\" \"your_api_key_here\" \"your_api_secret\"\n```\n\nサーバーが起動し、MCP クライアントの接続を待機します。\n\nClaude Desktop と併用する場合、Claude が設定ファイルを読み込むとサーバーが自動的に起動します。手動で起動する必要はありません。\n\n## PCIコンプライアンス\n\nこのサーバーは、決済カード情報をトークン化することでPCIコンプライアンスに準拠します。実際のカードデータはTwilioによって処理され、お客様のシステムに保存されることはありません。TwilioのPCIコンプライアンスに関する詳細は、 [Twilioの安全な決済に関するドキュメント](https://www.twilio.com/docs/voice/tutorials/secure-payment-processing)をご覧ください。\n\n## ライセンス\n\nマサチューセッツ工科大学\n\n## MCPインスペクターの互換性\n\nこのサーバーをMCPインスペクターと併用する場合、すべてのログ記録`console.log()`ではなくMCPログ機能を介して行われることに注意してください。これは意図的な動作であり、JSON通信にstdoutを使用するMCPプロトコルとの互換性を保つために必要です。\n\nこのサーバーを拡張したり、問題をデバッグしたりする場合:\n\n1. LOG\\_EVENTイベントを発行してイベントベースのログシステムを使用する\n2. `console.log()`の使用は避けてください。MCP プロトコルの JSON メッセージが標準出力に表示されるためです。\n3. MCPコンテキスト外でデバッグする場合は、stderrに出力する`console.error()`を使用できます。\n\n## イベントベースのログアーキテクチャ\n\nサーバーはイベントベースのログ記録アーキテクチャを使用します。\n\n1. **イベントエミッター**: すべてのツールクラスとリソースクラスは Node.js の`EventEmitter`を拡張し、レベルとメッセージデータを含む「ログ」イベントを出力します。\n\n2. **ログ転送**: これらのイベントはイベントリスナーによってキャプチャされ、MCP サーバーのログシステムに転送されます。\n\n ```javascript\n // Set up event listeners for tool logs\n startPaymentCaptureTool.on(LOG_EVENT, logToMcp);\n captureCardNumberTool.on(LOG_EVENT, logToMcp);\n // ... other tools\n ```\n\n3. **MCP 統合**: `logToMcp`関数は、これらのイベントを MCP 互換のログメッセージに変換します。\n\n ```javascript\n const logToMcp = (data: { level: string, message: string }) => {\n // Only use valid log levels: info, error, debug\n // If level is 'warn', treat it as 'info'\n const mcpLevel = data.level === 'warn' ? 'info' : data.level as \"info\" | \"error\" | \"debug\";\n\n // Send the log message to the MCP server's underlying Server instance\n mcpServer.server.sendLoggingMessage({\n level: mcpLevel,\n data: data.message,\n });\n };\n ```\n\n### サポートされているログレベル\n\nサーバーは次のログレベルをサポートしています。\n\n* `info` : 一般情報メッセージ\n* `error` : エラーメッセージと例外\n* `debug` : 詳細なデバッグ情報\n* `warn` : 警告メッセージ（MCP 互換性のため自動的に 'info' に変換されます）\n\n## 支払いコールバックデータ構造\n\nサーバーは、Twilio からの 2 つの主な種類のコールバックデータを処理します。\n\n### 初期コネクタデータ\n\n支払いセッションが最初に作成されると、Twilio はコネクタデータを送信します。\n\n```json\n{\n \"PaymentConnector\": \"PGP_MOCK\",\n \"DateCreated\": \"2021-08-10T03:55:53.408Z\",\n \"PaymentMethod\": \"credit-card\",\n \"CallSid\": \"CAzzzzz\",\n \"ChargeAmount\": \"9.99\",\n \"AccountSid\": \"ACxxxxx\",\n \"Sid\": \"PKxxxx\"\n}\n```\n\n### データのキャプチャ\n\n支払い情報が取得されると、Twilio は更新されたデータを送信します。\n\n```json\n{ \n \"SecurityCode\": \"xxx\",\n \"PaymentCardType\": \"visa\",\n \"Sid\": \"PKxxxx\",\n \"PaymentConfirmationCode\": \"ch_a9dc6297cd1a4fb095e61b1a9cf2dd1d\",\n \"CallSid\": \"CAxxxxx\",\n \"Result\": \"success\",\n \"AccountSid\": \"AC75xxxxxx\",\n \"ProfileId\": \"\",\n \"DateUpdated\": \"2021-08-10T03:58:27.290Z\",\n \"PaymentToken\": \"\",\n \"PaymentMethod\": \"credit-card\",\n \"PaymentCardNumber\": \"xxxxxxxxxxxx1111\",\n \"ExpirationDate\": \"1225\"\n}\n```\n\nサーバーは、このデータを支払い SID でインデックス付けして statusCallbackMap に保存し、PaymentStatusResource を通じて利用できるようにします。","Japanese","ja-JP",{"_29":55,"_33":59,"_38":60},{"_31":56,"_33":57,"_35":58},"Twilio API를 통한 음성 통화 중에 안전하고 PCI 규격에 맞는 결제 처리를 가능하게 하는 MCP 서버로, 에이전트 지원 결제를 위한 비동기 콜백과 안내 워크플로를 제공합니다.","Twilio Agent Payments MCP 서버","# Twilio Agent Payments MCP 서버\n\nTwilio API를 통해 에이전트 지원 결제를 처리할 수 있는 MCP(모델 컨텍스트 프로토콜) 서버로, 비동기 콜백과 상황에 맞는 프롬프트를 통한 안내 워크플로우를 위한 향상된 기능을 제공합니다.\n\n## 특징\n\n* Twilio를 통해 음성 통화 중에 안전한 결제를 처리하세요\n* 결제 정보(카드 번호, 보안 코드, 만료일)를 수집합니다.\n* PCI 규정 준수를 위한 결제 정보 토큰화\n* MCP 리소스를 통한 비동기 콜백\n* 결제 프로세스의 각 단계에 대한 MCP 프롬프트를 사용한 가이드 워크플로\n* 결제 정보 재입력 지원\n* Claude Desktop과 같은 MCP 클라이언트와 통합됩니다.\n* 보안 자격 증명 처리\n* 보안 강화를 위해 Twilio API 키를 사용합니다.\n* 이벤트 기반 로깅 아키텍처\n\n## 설치\n\nnpx를 통해 이 서버를 직접 사용할 수 있습니다.\n\n지엑스피1\n\n또는 전역적으로 설치하세요.\n\n```bash\nnpm install -g twilio-agent-payments-mcp-server\ntwilio-agent-payments-mcp-server \n```\n\n### 환경 매개변수\n\n서버를 설치할 때 다음 매개변수를 제공해야 합니다.\n\n1. **명령줄 인수** (필수):\n\n * `accountSid` : Twilio 계정 SID\n * `apiKey` : Twilio API 키\n * `apiSecret` : Twilio API 비밀번호\n\n2. **환경 변수** (서버 실행 전에 설정):\n\n * `TOKEN_TYPE` : 결제에 사용할 토큰 유형(예: '재사용 가능', '일회용')\n * `CURRENCY` : 지불 통화(예: 'USD', 'EUR')\n * `PAYMENT_CONNECTOR` : Twilio와 함께 사용할 결제 커넥터\n * `NGROK_AUTH_TOKEN` : Ngrok 인증 토큰(콜백 처리에 필요)\n * `NGROK_CUSTOM_DOMAIN` : Ngrok의 선택적 사용자 정의 도메인\n\n환경 변수의 예:\n\n```bash\nTOKEN_TYPE=reusable CURRENCY=USD PAYMENT_CONNECTOR=your_connector NGROK_AUTH_TOKEN=your_token npx twilio-agent-payments-mcp-server \n```\n\n이러한 매개변수에 대한 자세한 내용은 아래 구성 섹션을 참조하세요.\n\n## 구성\n\n서버에는 다음과 같은 매개변수가 필요합니다.\n\n* `accountSid` : Twilio 계정 SID(AC로 시작해야 하며, 검증됨)\n* `apiKey` : Twilio API 키(SK로 시작)\n* `apiSecret` : Twilio API 비밀번호\n\n### 환경 변수\n\n구성에는 다음 환경 변수가 사용됩니다.\n\n* `TOKEN_TYPE` : 결제에 사용할 토큰 유형(예: '재사용 가능', '일회용')\n* `CURRENCY` : 지불 통화(예: 'USD', 'EUR')\n* `PAYMENT_CONNECTOR` : Twilio와 함께 사용할 결제 커넥터\n* `NGROK_AUTH_TOKEN` : Ngrok 인증 토큰(콜백 처리에 필요)\n* `NGROK_CUSTOM_DOMAIN` : Ngrok의 선택적 사용자 정의 도메인\n\n참고: Twilio 자격 증명(accountSid, apiKey, apiSecret)은 환경 변수가 아닌 명령줄 인수로 제공됩니다.\n\n### 보안 참고 사항\n\n이 서버는 보안 강화를 위해 인증 토큰 대신 API 키와 비밀번호를 사용합니다. 이러한 접근 방식은 더 나은 액세스 제어 기능을 제공하고 필요한 경우 사용자 인증 정보를 취소할 수 있도록 합니다. 자세한 내용은 [Twilio API 키 문서를](https://www.twilio.com/docs/usage/requests-to-twilio) 참조하세요.\n\n## Claude Desktop과 함께 사용\n\n### 지역 개발\n\n로컬 개발의 경우(패키지가 npm에 게시되지 않은 경우), Claude Desktop 구성 파일(macOS에서는 `~/Library/Application Support/Claude/claude_desktop_config.json` , Windows에서는 `%APPDATA%\\Claude\\claude_desktop_config.json` )에 다음을 추가합니다.\n\n```json\n{\n \"mcpServers\": {\n \"twilio-agent-payments\": {\n \"command\": \"node\",\n \"args\": [\n \"/PATHTONODE/twilio-agent-payments-mcp-server/build/index.js\",\n \"your_account_sid_here\",\n \"your_api_key_here\",\n \"your_api_secret_here\"\n ],\n \"env\": {\n \"TOKEN_TYPE\": \"reusable\",\n \"CURRENCY\": \"USD\",\n \"PAYMENT_CONNECTOR\": \"your_connector_name\",\n \"NGROK_AUTH_TOKEN\": \"your_ngrok_auth_token_here\",\n \"NGROK_CUSTOM_DOMAIN\": \"your_custom_domain_here\" // Optional\n }\n }\n }\n}\n```\n\n값을 실제 Twilio 자격 증명 및 구성으로 바꾸세요.\n\n### npm에 게시한 후\n\n패키지가 npm에 게시되면 다음 구성을 사용할 수 있습니다.\n\n```json\n{\n \"mcpServers\": {\n \"twilio-agent-payments\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\", \n \"twilio-agent-payments-mcp-server\",\n \"your_account_sid_here\",\n \"your_api_key_here\",\n \"your_api_secret_here\"\n ],\n \"env\": {\n ...process.env, // Include existing environment variables so child process has access to the path\n \"TOKEN_TYPE\": \"reusable\",\n \"CURRENCY\": \"USD\",\n \"PAYMENT_CONNECTOR\": \"your_connector_name\",\n \"NGROK_AUTH_TOKEN\": \"your_ngrok_auth_token_here\",\n \"NGROK_CUSTOM_DOMAIN\": \"your_custom_domain_here\" // Optional\n }\n }\n }\n}\n```\n\n## 호스트 애플리케이션과의 통합\n\n모델 컨텍스트 프로토콜(MCP)의 주요 장점 중 하나는 LLM 컨텍스트를 수동으로 구성할 필요가 없다는 것입니다. MCP 서버는 필요한 모든 도구 정의, 리소스 템플릿 및 기능을 LLM 클라이언트에 자동으로 제공합니다.\n\n### 호스트 애플리케이션 설정\n\n이 MCP 서버를 자체 호스트 애플리케이션에 통합하려면:\n\n1. **MCP 클라이언트 구현** : 기존 MCP 클라이언트 라이브러리를 사용하거나 애플리케이션에서 MCP 클라이언트 프로토콜을 구현합니다.\n\n2. **MCP 서버에 연결** : Twilio Agent Payments MCP 서버에 연결하도록 애플리케이션을 구성합니다.\n\n3. **나머지는 프로토콜에 맡기세요. MCP 서버는 자동으로 다음을** 수행합니다.\n\n * 클라이언트에게 도구와 리소스를 등록하세요\n * 모든 도구에 대한 입력 스키마 제공\n * LLM이 결제 흐름을 안내할 수 있도록 상황에 맞는 프롬프트를 제공합니다.\n\nLLM 컨텍스트에서는 도구나 리소스를 수동으로 정의할 필요가 없습니다. MCP 프로토콜이 이러한 검색을 자동으로 처리합니다.\n\n### 통합 코드 예시\n\nMCP 클라이언트와 통합하는 방법에 대한 간단한 예는 다음과 같습니다.\n\n```javascript\n// Initialize your MCP client\nconst mcpClient = new McpClient();\n\n// Connect to the Twilio Agent Payments MCP server\nawait mcpClient.connectToServer({\n name: \"twilio-agent-payments\",\n // Connection details depend on your specific MCP client implementation\n // This could be a WebSocket URL, stdio connection, or other transport\n});\n\n// The client will automatically discover available tools and resources\n\n// When the LLM wants to use a tool, your application can handle it like this:\nfunction handleLlmToolRequest(toolRequest) {\n // The toolRequest would contain:\n // - server_name: \"twilio-agent-payments\"\n // - tool_name: e.g., \"startPaymentCapture\"\n // - arguments: e.g., { callSid: \"CA1234567890abcdef\" }\n \n return mcpClient.callTool(toolRequest);\n}\n\n// Similarly for resources:\nfunction handleLlmResourceRequest(resourceRequest) {\n // The resourceRequest would contain:\n // - server_name: \"twilio-agent-payments\"\n // - uri: e.g., \"payment://CA1234567890abcdef/PA9876543210abcdef/status\"\n \n return mcpClient.accessResource(resourceRequest);\n}\n```\n\n### 최소 LLM 컨텍스트 필요\n\nLLM은 결제 처리를 위해 Twilio Agent Payments MCP 서버를 사용할 수 있다는 사실만 알면 됩니다. 시스템 프롬프트에 간단한 지침을 입력하면 됩니다.\n\n```\nYou have access to a Twilio Agent Payments MCP server that can help process secure payments during voice calls. \nWhen a customer wants to make a payment, you can use the tools provided by this server to securely capture \npayment information while maintaining PCI compliance.\n\nThe server will guide you through the payment process with contextual prompts at each step.\n```\n\nMCP 서버 자체는 LLM이 결제 흐름을 안내하는 데 필요한 모든 세부적인 도구 정의, 입력 스키마 및 상황에 맞는 프롬프트를 제공합니다.\n\n## 개발자 구현 참고 사항\n\n이 섹션에서는 MCP 서버 구현이 다양한 구성 요소와 파일에 어떻게 구성되는지, 그리고 사용된 아키텍처 패턴에 초점을 맞춰 설명합니다.\n\n### 구성 요소 구성\n\n서버 구현은 여러 디렉토리로 나뉩니다.\n\n1. **src/index.ts** : 다음을 수행하는 주요 진입점:\n\n * MCP 서버를 초기화합니다\n * TwilioAgentPaymentServer 싱글톤을 초기화합니다.\n * 자동 검색을 통해 모든 구성 요소를 MCP 서버로 검색하고 등록합니다.\n * 로깅을 위한 이벤트 리스너를 설정합니다.\n * 서버를 전송 계층에 연결합니다.\n\n2. **src/tools/** : 개별 도구 구현을 포함합니다.\n\n * 각 도구는 이름, 설명, 모양 및 실행 속성을 포함하는 객체를 반환하는 팩토리 함수로 구현됩니다.\n * 도구는 특정 결제 작업을 처리합니다(예: StartPaymentCaptureTool, CaptureCardNumberTool)\n * 각 도구는 Zod를 사용하여 입력 스키마를 정의하고 실행 메서드를 구현합니다.\n * 도구는 getInstance()를 통해 TwilioAgentPaymentServer 싱글톤에 액세스합니다.\n\n3. **src/prompts/** : 프롬프트 구현을 포함합니다.\n\n * 각 프롬프트는 이름, 설명 및 실행 속성이 있는 객체를 반환하는 팩토리 함수로 구현됩니다.\n * 프롬프트는 지불 흐름의 각 단계에 대한 LLM에 상황적 지침을 제공합니다.\n * 일부 프롬프트는 프롬프트 콘텐츠를 사용자 정의하는 데 사용할 수 있는 매개변수를 허용합니다.\n\n4. **src/resources/** : 리소스 구현을 포함합니다.\n\n * 리소스는 데이터에 대한 액세스를 제공합니다(예: PaymentStatusResource)\n * 각 리소스는 이름, 템플릿, 설명 및 읽기 속성을 포함하는 객체를 반환하는 팩토리 함수로 구현됩니다.\n * 리소스는 getInstance()를 통해 TwilioAgentPaymentServer 싱글톤에 액세스합니다.\n\n5. **src/api-servers/** : Twilio API 클라이언트 구현을 포함합니다.\n\n * TwilioAgentPaymentServer를 싱글톤으로 구현합니다.\n * Twilio API와의 통신을 처리합니다.\n * 결제 세션 상태를 관리합니다\n * 싱글톤 인스턴스에 액세스하기 위한 정적 메서드를 제공합니다.\n\n6. **src/utils/** : 유틸리티 함수가 들어있습니다.\n\n * autoDiscovery.ts 파일은 도구, 프롬프트 및 리소스의 자동 검색 및 등록을 처리합니다.\n\n### TwilioAgentPaymentServer를 위한 싱글톤 패턴\n\n이 코드베이스의 핵심 아키텍처 패턴은 TwilioAgentPaymentServer에 대한 Singleton 패턴을 사용하는 것입니다.\n\n```typescript\nclass TwilioAgentPaymentServer extends EventEmitter {\n // Singleton instance\n private static instance: TwilioAgentPaymentServer | null = null;\n\n /**\n * Static method to get the instance\n */\n public static getInstance(): TwilioAgentPaymentServer {\n if (!TwilioAgentPaymentServer.instance) {\n throw new Error('TwilioAgentPaymentServer not initialized. Call initialize() first.');\n }\n return TwilioAgentPaymentServer.instance;\n }\n \n /**\n * Static method to initialize the instance\n */\n public static initialize(accountSid: string, apiKey: string, apiSecret: string): TwilioAgentPaymentServer {\n if (!TwilioAgentPaymentServer.instance) {\n TwilioAgentPaymentServer.instance = new TwilioAgentPaymentServer(accountSid, apiKey, apiSecret);\n }\n return TwilioAgentPaymentServer.instance;\n }\n\n // Private constructor to prevent direct instantiation\n private constructor(accountSid: string, apiKey: string, apiSecret: string) {\n // Initialization code...\n }\n}\n```\n\n이 접근 방식의 이점:\n\n* 애플리케이션 전체에서 TwilioAgentPaymentServer 인스턴스가 하나만 있는지 확인합니다.\n* 여러 함수를 통해 인스턴스를 전달할 필요성이 없어집니다.\n* 더 간단한 함수 서명으로 더 깔끔한 API를 제공합니다.\n* 코드베이스의 어느 곳에서나 TwilioAgentPaymentServer에 더 쉽게 액세스할 수 있습니다.\n\n### 팩토리 함수 패턴\n\n도구, 프롬프트 및 리소스는 팩토리 함수 패턴을 사용하여 구현됩니다.\n\n1. **도구에서** :\n\n ```typescript\n // Example from StartPaymentCaptureTool.ts\n export function startPaymentCaptureTool() {\n // Get the TwilioAgentPaymentServer instance\n const twilioAgentPaymentServer = TwilioAgentPaymentServer.getInstance();\n \n // Create an event emitter for logging\n const emitter = new EventEmitter();\n \n return {\n name: \"startPaymentCapture\",\n description: \"Start a new payment capture session\",\n shape: schema.shape,\n execute: async function execute(params: z.infer, extra: any): Promise {\n // Implementation that calls Twilio API and returns result\n },\n emitter // For attaching event listeners\n }\n }\n ```\n\n2. **리소스에서** :\n\n ```typescript\n // Example from PaymentStatusResource.ts\n export function paymentStatusResource() {\n // Get the TwilioAgentPaymentServer instance\n const twilioAgentPaymentServer = TwilioAgentPaymentServer.getInstance();\n \n // Create an event emitter for logging\n const emitter = new EventEmitter();\n \n return {\n name: \"PaymentStatus\",\n template: new ResourceTemplate(\"payment://{callSid}/{paymentSid}/status\", { list: undefined }),\n description: \"Get the current status of a payment session\",\n read: async (uri: URL, variables: Record, extra: any): Promise => {\n // Implementation that retrieves and formats payment status data\n },\n emitter // For attaching event listeners\n };\n }\n ```\n\n3. **프롬프트에서** :\n\n ```typescript\n // Example from a prompt factory function\n export function startCapturePrompt() {\n return {\n name: \"StartCapture\",\n description: \"Prompt for starting the payment capture process\",\n execute: (args: { callSid: string }, extra: RequestHandlerExtra): GetPromptResult | Promise => {\n // Return prompt content\n }\n };\n }\n ```\n\n### 자동 검색 및 등록\n\n서버는 자동 검색 메커니즘을 사용하여 모든 구성 요소를 찾아 등록합니다.\n\n```typescript\n// In src/utils/autoDiscovery.ts\nexport async function discoverComponents(mcpServer: McpServer) {\n // Get the current directory path\n const basePath: string = path.dirname(fileURLToPath(import.meta.url));\n\n await Promise.all([\n discoverTools(mcpServer, path.join(basePath, '../tools')),\n discoverPrompts(mcpServer, path.join(basePath, '../prompts')),\n discoverResources(mcpServer, path.join(basePath, '../resources'))\n ]);\n}\n```\n\n이 접근 방식은 다음과 같습니다.\n\n* 각 디렉토리에 있는 모든 도구, 프롬프트 및 리소스를 자동으로 찾습니다.\n* 동적으로 가져와 MCP 서버에 등록합니다.\n* 메인 파일을 수정하지 않고도 새로운 구성요소를 쉽게 추가할 수 있습니다.\n* 보일러플레이트 코드를 줄이고 유지 관리성을 향상시킵니다.\n\n### 프롬프트의 매개변수\n\n일부 프롬프트는 프롬프트 내용을 사용자 지정하는 데 사용할 수 있는 매개변수를 허용합니다. StartCapturePrompt가 좋은 예입니다.\n\n1. **매개변수 정의** :\n\n ```typescript\n // In the prompt factory function\n return {\n name: \"StartCapture\",\n description: \"Prompt for starting the payment capture process\",\n schema: { callSid: z.string().describe(\"The Twilio Call SID\") }, // Parameter schema\n execute: (args: { callSid: string }, extra: RequestHandlerExtra) => {\n // Implementation\n }\n };\n ```\n\n * 스키마 속성은 Zod를 사용하여 매개변수 스키마를 정의합니다.\n * 이 경우에는 문자열 유형의 `callSid` 매개변수가 필요합니다.\n\n2. **프롬프트에서의 매개변수 사용** :\n\n ```typescript\n execute: (args: { callSid: string }, extra: RequestHandlerExtra): GetPromptResult | Promise => {\n const { callSid } = args;\n\n if (!callSid) {\n throw new Error(\"callSid parameter is required\");\n }\n \n return {\n messages: [\n {\n role: \"assistant\",\n content: {\n type: \"text\",\n text: getStartCapturePromptText(callSid), // Use the parameter in the prompt text\n }\n }\n ]\n };\n }\n ```\n\n * 실행 메서드는 매개변수를 첫 번째 인수로 허용합니다.\n * 매개변수를 검증하고 이를 사용하여 프롬프트 콘텐츠를 사용자 정의할 수 있습니다.\n * 이 경우, callSid는 컨텍스트를 제공하기 위해 프롬프트 텍스트에 사용됩니다.\n\n이 패턴을 사용하면 결제 흐름의 현재 상태에 따라 맞춤형 안내를 제공하여 동적이고 상황에 맞는 프롬프트를 제공할 수 있습니다.\n\n## 사용 가능한 도구\n\n### 시작결제캡처\n\n활성 통화에 대한 결제 캡처 프로세스를 시작합니다.\n\n매개변수:\n\n* `callSid` : 활성 호출에 대한 Twilio 호출 SID\n\n중요: StartCapturePrompt.ts를 사용하려면 사용자가 MCP 클라이언트 측에서 호출 SID를 입력해야 합니다. 이는 필수 매개변수이며, 입력하지 않으면 프롬프트에서 오류가 발생합니다.\n\n참고: Twilio 통화를 처리할 때는 어떤 통화 레그(leg)의 통화 SID를 사용하는지 파악해야 합니다. Twilio Payments는 PSTN 측 통화 레그에 연결해야 합니다. Twilio 클라이언트 측에 적용되는 경우 DTMF 숫자가 캡처되지 않습니다. 따라서 이 MCP 서버는 올바른 통화 레그가 사용되고 있다고 가정합니다. 일반적으로 다음과 같이 확인합니다.\n\n```javascript\n // Pseudo code: direction of the call\n if (event.CallDirection === \"toPSTN\") {\n theCallSid = event.CallSid;\n }\n\n if (event.CallDirection == \"toSIP\") {\n theCallSid = event.ParentCallSid;\n }\n```\n\n보고:\n\n* `paymentSid` : 새로운 결제 세션에 대한 Twilio 결제 SID\n\n### 캡처카드번호\n\n결제 카드 번호 캡처를 시작합니다.\n\n매개변수:\n\n* `callSid` : 활성 호출에 대한 Twilio 호출 SID\n* `paymentSid` : 결제 세션에 대한 Twilio 결제 SID\n* `captureType` : '결제 카드 번호'로 설정\n\n보고:\n\n* 카드번호 캡처 작업 상태\n\n### captureSecurityCode\n\n카드 보안 코드 캡처를 시작합니다.\n\n매개변수:\n\n* `callSid` : 활성 호출에 대한 Twilio 호출 SID\n* `paymentSid` : 결제 세션에 대한 Twilio 결제 SID\n* `captureType` : 'security-code'로 설정\n\n보고:\n\n* 보안 코드 캡처 작업 상태\n\n### 캡처만료일\n\n카드 만료일 캡처를 시작합니다.\n\n매개변수:\n\n* `callSid` : 활성 호출에 대한 Twilio 호출 SID\n* `paymentSid` : 결제 세션에 대한 Twilio 결제 SID\n* `captureType` : '만료일'로 설정\n\n보고:\n\n* 만료일 캡처 작업 상태\n\n### 결제 완료 캡처\n\n결제 캡처 세션을 완료합니다.\n\n매개변수:\n\n* `callSid` : 활성 호출에 대한 Twilio 호출 SID\n* `paymentSid` : 결제 세션에 대한 Twilio 결제 SID\n\n보고:\n\n* 결제 완료 작업 상태\n\n## 사용 가능한 리소스\n\n### 결제://{callSid}/{paymentSid}/상태\n\n결제 세션의 현재 상태를 JSON 객체로 가져옵니다. 이 리소스는 다음을 포함하여 결제 캡처 프로세스의 현재 상태에 대한 자세한 정보를 제공합니다.\n\n* 결제 SID\n* 결제 카드 번호(마스킹)\n* 결제 카드 종류\n* 보안 코드 상태\n* 유효기간\n* 결제 확인 코드\n* 결제 결과\n* 결제 토큰\n\n## MCP 프롬프트\n\n서버는 LLM이 결제 흐름의 각 단계를 안내할 수 있도록 상황에 맞는 프롬프트를 제공합니다.\n\n### 캡처 시작 프롬프트\n\n다음을 포함하여 결제 수집 프로세스를 시작하는 방법에 대한 지침을 제공합니다.\n\n* 고객에게 결제 정보를 제공할 준비가 되었는지 묻는 지침\n* 보안 처리 및 토큰화에 대한 설명\n* startPaymentCapture 도구를 사용하는 단계\n* **중요** : 사용자는 MCP 클라이언트 측에서 호출 SID를 입력해야 합니다. 이는 필수 매개변수입니다.\n\n### 카드번호 프롬프트\n\n다음을 포함하여 카드 번호 수집 프로세스를 처리하는 방법에 대한 LLM 지침을 제공합니다.\n\n* 고객에게 필요한 정보를 설명하기 위한 지침\n* 고객 질문이나 우려 사항을 처리하기 위한 팁\n* captureCardNumber 도구를 사용하는 단계\n\n### 보안 코드 프롬프트\n\n다음을 포함하여 카드 보안 코드를 캡처하는 방법에 대한 지침을 제공합니다.\n\n* 보안 코드가 무엇인지 설명하는 지침\n* 고객 질문이나 우려 사항을 처리하기 위한 팁\n* captureSecurityCode 도구를 사용하는 단계\n\n### 만료일 프롬프트\n\n다음을 포함하여 카드 만료일을 파악하는 방법에 대한 LLM 지침을 제공합니다.\n\n* 필요한 형식(MM/YY)을 설명하기 위한 지침\n* 고객 질문이나 우려 사항을 처리하기 위한 팁\n* captureExpirationDate 도구를 사용하는 단계\n\n### 캡처 완료 프롬프트\n\n다음을 포함하여 결제 수집 프로세스를 완료하는 방법에 대한 지침을 제공합니다.\n\n* 모든 정보가 수집되었는지 확인하기 위한 지침\n* completePaymentCapture 도구를 사용하는 단계\n\n### 완료 프롬프트\n\n결제가 성공적으로 처리된 후 LLM이 수행해야 할 작업에 대해 안내합니다. 여기에는 다음이 포함됩니다.\n\n* 결제 성공 확인 안내\n* 대화의 다음 단계에 대한 제안\n\n### 오류 프롬프트\n\n다음을 포함하여 결제 수집 프로세스 중 발생하는 오류를 처리하는 방법에 대한 지침을 제공합니다.\n\n* 고객에게 오류를 설명하기 위한 지침\n* 일반적인 문제 해결을 위한 제안\n* 결제 캡처 프로세스를 다시 시도하기 위한 단계\n\n## 건축학\n\n이 MCP 서버는 결제 흐름을 처리하기 위한 향상된 아키텍처를 구현합니다.\n\n### 이벤트 기반 아키텍처\n\n서버는 구성 요소 간 통신을 위해 EventEmitter를 사용하는 이벤트 기반 아키텍처를 사용합니다.\n\n* 각 도구, 리소스 및 서버 구성 요소는 EventEmitter를 확장합니다.\n* 구성 요소는 로깅 및 콜백을 위해 이벤트를 방출합니다.\n* 이벤트 리스너는 로그를 MCP 서버의 로깅 시스템으로 전달합니다.\n\n### 콜백 처리\n\n서버는 @deshartman/mcp-status-callback 패키지를 사용하여 Twilio의 비동기 콜백을 처리합니다.\n\n* Ngrok을 사용하여 콜백을 수신하기 위한 보안 터널을 생성합니다.\n* 다양한 결제 단계에 대한 콜백을 처리합니다.\n* 콜백 데이터를 기반으로 상태 저장소를 업데이트합니다.\n* 오류 조건 및 재진입 시나리오를 처리합니다.\n\n### 국가 관리\n\n결제 상태는 지도 기반 스토어를 통해 관리됩니다.\n\n* statusCallbackMap은 결제 SID로 인덱싱된 결제 세션 데이터를 저장합니다.\n* 각 콜백은 최신 정보로 상태를 업데이트합니다.\n* PaymentStatusResource는 이 상태 데이터에 대한 액세스를 제공합니다.\n\n### MCP 통합\n\n서버는 다음을 통해 MCP 프로토콜과 통합됩니다.\n\n* 도구: 입력 검증을 위해 Zod 스키마로 정의됨\n* 리소스: 결제 상태 데이터에 대한 액세스 제공\n* 프롬프트: 결제 흐름의 각 단계에 대한 상황별 안내\n* 로깅: 이벤트 기반 로깅이 MCP 서버로 전달됨\n\n## 개발\n\n프로젝트를 빌드하려면:\n\n```bash\nnpm install\nnpm run build\n```\n\n### 필수 조건\n\n* 노드.js 18+\n* Express(콜백 처리용)\n* 트윌리오 SDK\n* 인증 토큰이 있는 Ngrok 계정\n\n### 수동으로 서버 실행\n\n테스트를 위해 서버를 수동으로 시작하려면(Claude Desktop 외부):\n\n```bash\n# Run with actual credentials\nnode build/index.js \"your_account_sid_here\" \"your_api_key_here\" \"your_api_secret\"\n\n# Or use the npm script (which uses ts-node for development)\nnpm run dev -- \"your_account_sid_here\" \"your_api_key_here\" \"your_api_secret\"\n```\n\n서버가 시작되어 MCP 클라이언트 연결을 기다립니다.\n\nClaude Desktop과 함께 사용하는 경우, Claude가 구성 파일을 로드하면 서버가 자동으로 시작됩니다. 수동으로 시작할 필요가 없습니다.\n\n## PCI 규정 준수\n\n이 서버는 결제 카드 정보를 토큰화하여 PCI 규정 준수를 지원합니다. 실제 카드 데이터는 Twilio에서 처리되며 시스템에 저장되지 않습니다. Twilio의 PCI 규정 준수에 대한 자세한 내용은 [Twilio의 보안 결제 관련 문서를](https://www.twilio.com/docs/voice/tutorials/secure-payment-processing) 참조하세요.\n\n## 특허\n\nMIT\n\n## MCP 검사기 호환성\n\n이 서버를 MCP Inspector와 함께 사용할 경우, 모든 로깅은 `console.log()` 대신 MCP 로깅 기능을 통해 수행됩니다. 이는 JSON 통신에 stdout을 사용하는 MCP 프로토콜과의 호환성을 위해 의도적으로 설정된 기능입니다.\n\n이 서버를 확장하거나 문제를 디버깅하는 경우:\n\n1. LOG\\_EVENT 이벤트를 내보내 이벤트 기반 로깅 시스템을 사용합니다.\n2. MCP 프로토콜의 stdout JSON 메시지를 방해할 수 있으므로 `console.log()` 사용하지 마십시오.\n3. MCP 컨텍스트 외부에서 디버깅하려면 stderr에 출력하는 `console.error()` 사용할 수 있습니다.\n\n## 이벤트 기반 로깅 아키텍처\n\n서버는 이벤트 기반 로깅 아키텍처를 사용합니다.\n\n1. **이벤트 방출기** : 모든 도구 및 리소스 클래스는 Node.js의 `EventEmitter` 확장하고 레벨 및 메시지 데이터가 포함된 '로그' 이벤트를 방출합니다.\n\n2. **로그 전달** : 이러한 이벤트는 이벤트 리스너에 의해 캡처되어 MCP 서버의 로깅 시스템으로 전달됩니다.\n\n ```javascript\n // Set up event listeners for tool logs\n startPaymentCaptureTool.on(LOG_EVENT, logToMcp);\n captureCardNumberTool.on(LOG_EVENT, logToMcp);\n // ... other tools\n ```\n\n3. **MCP 통합** : `logToMcp` 함수는 다음 이벤트를 MCP 호환 로그 메시지로 변환합니다.\n\n ```javascript\n const logToMcp = (data: { level: string, message: string }) => {\n // Only use valid log levels: info, error, debug\n // If level is 'warn', treat it as 'info'\n const mcpLevel = data.level === 'warn' ? 'info' : data.level as \"info\" | \"error\" | \"debug\";\n\n // Send the log message to the MCP server's underlying Server instance\n mcpServer.server.sendLoggingMessage({\n level: mcpLevel,\n data: data.message,\n });\n };\n ```\n\n### 지원되는 로그 수준\n\n서버는 다음과 같은 로그 수준을 지원합니다.\n\n* `info` : 일반 정보 메시지\n* `error` : 오류 메시지 및 예외\n* `debug` : 자세한 디버깅 정보\n* `warn` : 경고 메시지(MCP 호환성을 위해 자동으로 '정보'로 변환됨)\n\n## 결제 콜백 데이터 구조\n\n서버는 Twilio에서 두 가지 주요 유형의 콜백 데이터를 처리합니다.\n\n### 초기 커넥터 데이터\n\n결제 세션이 처음 생성되면 Twilio는 커넥터 데이터를 보냅니다.\n\n```json\n{\n \"PaymentConnector\": \"PGP_MOCK\",\n \"DateCreated\": \"2021-08-10T03:55:53.408Z\",\n \"PaymentMethod\": \"credit-card\",\n \"CallSid\": \"CAzzzzz\",\n \"ChargeAmount\": \"9.99\",\n \"AccountSid\": \"ACxxxxx\",\n \"Sid\": \"PKxxxx\"\n}\n```\n\n### 데이터 캡처\n\n결제 정보가 수집되면 Twilio는 업데이트된 데이터를 전송합니다.\n\n```json\n{ \n \"SecurityCode\": \"xxx\",\n \"PaymentCardType\": \"visa\",\n \"Sid\": \"PKxxxx\",\n \"PaymentConfirmationCode\": \"ch_a9dc6297cd1a4fb095e61b1a9cf2dd1d\",\n \"CallSid\": \"CAxxxxx\",\n \"Result\": \"success\",\n \"AccountSid\": \"AC75xxxxxx\",\n \"ProfileId\": \"\",\n \"DateUpdated\": \"2021-08-10T03:58:27.290Z\",\n \"PaymentToken\": \"\",\n \"PaymentMethod\": \"credit-card\",\n \"PaymentCardNumber\": \"xxxxxxxxxxxx1111\",\n \"ExpirationDate\": \"1225\"\n}\n```\n\n서버는 이 데이터를 결제 SID로 인덱싱된 statusCallbackMap에 저장하고 PaymentStatusResource를 통해 사용할 수 있도록 합니다.","Korean","ko-KR",{"_29":62,"_33":66,"_38":67},{"_31":63,"_33":64,"_35":65},"MCP 服务器可通过 Twilio API 在语音通话期间实现安全、符合 PCI 标准的支付处理，为代理协助支付提供异步回调和指导工作流程。","Twilio 代理支付 MCP 服务器","# Twilio 代理支付 MCP 服务器\n\nMCP（模型上下文协议）服务器可通过 Twilio API 处理代理协助支付，并具有异步回调和通过上下文提示引导工作流程的增强功能。\n\n## 特征\n\n* 通过 Twilio 在语音通话期间处理安全支付\n* 获取付款信息（卡号、安全码、有效期）\n* 标记支付信息以符合 PCI 合规性\n* 通过 MCP 资源进行异步回调\n* 使用 MCP Prompts 指导支付流程的每个步骤\n* 支持重新输入付款信息\n* 与 Claude Desktop 等 MCP 客户端集成\n* 安全凭证处理\n* 使用 Twilio API 密钥来提高安全性\n* 基于事件的日志记录架构\n\n## 安装\n\n您可以通过 npx 直接使用此服务器：\n\n```bash\nnpx twilio-agent-payments-mcp-server \n```\n\n或者全局安装：\n\n```bash\nnpm install -g twilio-agent-payments-mcp-server\ntwilio-agent-payments-mcp-server \n```\n\n### 环境参数\n\n安装服务器时需要提供以下参数：\n\n1. **命令行参数**（必需）：\n\n * `accountSid` ：您的 Twilio 帐户 SID\n * `apiKey` ：您的 Twilio API 密钥\n * `apiSecret` ：您的 Twilio API 密钥\n\n2. **环境变量**（运行服务器之前设置）：\n\n * `TOKEN_TYPE` ：用于付款的令牌类型（例如“可重复使用”、“一次性”）\n * `CURRENCY` ：付款货币（例如“USD”、“EUR”）\n * `PAYMENT_CONNECTOR` ：与 Twilio 一起使用的支付连接器\n * `NGROK_AUTH_TOKEN` ：您的 Ngrok 身份验证令牌（回调处理所需）\n * `NGROK_CUSTOM_DOMAIN` ：Ngrok 的可选自定义域\n\n环境变量示例：\n\n```bash\nTOKEN_TYPE=reusable CURRENCY=USD PAYMENT_CONNECTOR=your_connector NGROK_AUTH_TOKEN=your_token npx twilio-agent-payments-mcp-server \n```\n\n有关这些参数的更多详细信息，请参阅下面的配置部分。\n\n## 配置\n\n服务器需要以下参数：\n\n* `accountSid` ：您的 Twilio 帐户 SID（必须以“AC”开头，将被验证）\n* `apiKey` ：您的 Twilio API 密钥（以“SK”开头）\n* `apiSecret` ：您的 Twilio API 密钥\n\n### 环境变量\n\n以下环境变量用于配置：\n\n* `TOKEN_TYPE` ：用于付款的令牌类型（例如“可重复使用”、“一次性”）\n* `CURRENCY` ：付款货币（例如“USD”、“EUR”）\n* `PAYMENT_CONNECTOR` ：与 Twilio 一起使用的支付连接器\n* `NGROK_AUTH_TOKEN` ：您的 Ngrok 身份验证令牌（回调处理所需）\n* `NGROK_CUSTOM_DOMAIN` ：Ngrok 的可选自定义域\n\n注意：Twilio 凭证（accountSid、apiKey、apiSecret）作为命令行参数提供，而不是环境变量。\n\n### 安全说明\n\n此服务器使用 API 密钥和机密信息（而非身份验证令牌）来提高安全性。此方法提供了更好的访问控制，并能够在需要时撤销凭证。有关更多信息，请参阅[Twilio API 密钥文档](https://www.twilio.com/docs/usage/requests-to-twilio)。\n\n## 与 Claude Desktop 一起使用\n\n### 本地开发\n\n对于本地开发（当软件包未发布到 npm 时），将以下内容添加到您的 Claude Desktop 配置文件（macOS 上的`~/Library/Application Support/Claude/claude_desktop_config.json`或 Windows 上的`%APPDATA%\\Claude\\claude_desktop_config.json` ）中：\n\n```json\n{\n \"mcpServers\": {\n \"twilio-agent-payments\": {\n \"command\": \"node\",\n \"args\": [\n \"/PATHTONODE/twilio-agent-payments-mcp-server/build/index.js\",\n \"your_account_sid_here\",\n \"your_api_key_here\",\n \"your_api_secret_here\"\n ],\n \"env\": {\n \"TOKEN_TYPE\": \"reusable\",\n \"CURRENCY\": \"USD\",\n \"PAYMENT_CONNECTOR\": \"your_connector_name\",\n \"NGROK_AUTH_TOKEN\": \"your_ngrok_auth_token_here\",\n \"NGROK_CUSTOM_DOMAIN\": \"your_custom_domain_here\" // Optional\n }\n }\n }\n}\n```\n\n用您的实际 Twilio 凭证和配置替换这些值。\n\n### 发布到 npm 后\n\n一旦包发布到 npm，您就可以使用以下配置：\n\n```json\n{\n \"mcpServers\": {\n \"twilio-agent-payments\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\", \n \"twilio-agent-payments-mcp-server\",\n \"your_account_sid_here\",\n \"your_api_key_here\",\n \"your_api_secret_here\"\n ],\n \"env\": {\n ...process.env, // Include existing environment variables so child process has access to the path\n \"TOKEN_TYPE\": \"reusable\",\n \"CURRENCY\": \"USD\",\n \"PAYMENT_CONNECTOR\": \"your_connector_name\",\n \"NGROK_AUTH_TOKEN\": \"your_ngrok_auth_token_here\",\n \"NGROK_CUSTOM_DOMAIN\": \"your_custom_domain_here\" // Optional\n }\n }\n }\n}\n```\n\n## 与主机应用程序集成\n\n模型上下文协议 (MCP) 的主要优势之一是它消除了 LLM 上下文的大量手动配置需求。MCP 服务器会自动向 LLM 客户端提供所有必要的工具定义、资源模板和功能。\n\n### 设置主机应用程序\n\n要将此 MCP 服务器集成到您自己的主机应用程序中：\n\n1. **实现 MCP 客户端**：使用现有的 MCP 客户端库或在您的应用程序中实现 MCP 客户端协议。\n\n2. **连接到 MCP 服务器**：配置您的应用程序以连接到 Twilio Agent Payments MCP 服务器。\n\n3. **让协议处理其余部分**：MCP 服务器将自动：\n\n * 向您的客户注册其工具和资源\n * 为所有工具提供输入模式\n * 提供上下文提示，指导法学硕士完成付款流程\n\n您的 LLM 上下文中不需要手动定义工具或资源 - MCP 协议会自动处理此发现。\n\n### 示例集成代码\n\n以下是如何与 MCP 客户端集成的简化示例：\n\n```javascript\n// Initialize your MCP client\nconst mcpClient = new McpClient();\n\n// Connect to the Twilio Agent Payments MCP server\nawait mcpClient.connectToServer({\n name: \"twilio-agent-payments\",\n // Connection details depend on your specific MCP client implementation\n // This could be a WebSocket URL, stdio connection, or other transport\n});\n\n// The client will automatically discover available tools and resources\n\n// When the LLM wants to use a tool, your application can handle it like this:\nfunction handleLlmToolRequest(toolRequest) {\n // The toolRequest would contain:\n // - server_name: \"twilio-agent-payments\"\n // - tool_name: e.g., \"startPaymentCapture\"\n // - arguments: e.g., { callSid: \"CA1234567890abcdef\" }\n \n return mcpClient.callTool(toolRequest);\n}\n\n// Similarly for resources:\nfunction handleLlmResourceRequest(resourceRequest) {\n // The resourceRequest would contain:\n // - server_name: \"twilio-agent-payments\"\n // - uri: e.g., \"payment://CA1234567890abcdef/PA9876543210abcdef/status\"\n \n return mcpClient.accessResource(resourceRequest);\n}\n```\n\n### 最低限度的法学硕士背景要求\n\nLLM 只需要知道可以使用 Twilio Agent Payments MCP 服务器来处理付款。系统提示符中的一条简单指令即可：\n\n```\nYou have access to a Twilio Agent Payments MCP server that can help process secure payments during voice calls. \nWhen a customer wants to make a payment, you can use the tools provided by this server to securely capture \npayment information while maintaining PCI compliance.\n\nThe server will guide you through the payment process with contextual prompts at each step.\n```\n\nMCP 服务器本身提供所有详细的工具定义、输入模式和上下文提示，以指导 LLM 完成支付流程。\n\n## 开发人员实施说明\n\n本节介绍如何在不同的组件和文件中组织 MCP 服务器实现，重点介绍所使用的架构模式。\n\n### 组件组织\n\n服务器实现分为几个目录：\n\n1. **src/index.ts** ：主要入口点：\n\n * 初始化 MCP 服务器\n * 初始化 TwilioAgentPaymentServer 单例\n * 通过自动发现功能发现并向 MCP 服务器注册所有组件\n * 设置日志记录事件监听器\n * 将服务器连接到传输层\n\n2. **src/tools/** ：包含各个工具实现\n\n * 每个工具都实现为一个工厂函数，该函数返回一个具有名称、描述、形状和执行属性的对象。\n * 工具处理特定的支付操作（例如，StartPaymentCaptureTool，CaptureCardNumberTool）\n * 每个工具都使用 Zod 定义其输入模式并实现执行方法\n * 工具通过 getInstance() 访问 TwilioAgentPaymentServer 单例\n\n3. **src/prompts/** ：包含提示实现\n\n * 每个提示都实现为一个工厂函数，该函数返回一个具有名称、描述和执行属性的对象。\n * 提示为 LLM 支付流程的每个步骤提供上下文指导\n * 一些提示接受可用于自定义提示内容的参数\n\n4. **src/resources/** ：包含资源实现\n\n * 资源提供对数据的访问（例如 PaymentStatusResource）\n * 每个资源都实现为一个工厂函数，该函数返回一个具有名称、模板、描述和读取属性的对象。\n * 资源通过 getInstance() 访问 TwilioAgentPaymentServer 单例\n\n5. **src/api-servers/** ：包含 Twilio API 客户端的实现\n\n * 将 TwilioAgentPaymentServer 实现为单例\n * 处理与 Twilio API 的通信\n * 管理支付会话状态\n * 提供访问单例实例的静态方法\n\n6. **src/utils/** ：包含实用函数\n\n * autoDiscovery.ts 文件处理工具、提示和资源的自动发现和注册\n\n### TwilioAgentPaymentServer 的单例模式\n\n此代码库中的一个关键架构模式是 TwilioAgentPaymentServer 使用 Singleton 模式：\n\n```typescript\nclass TwilioAgentPaymentServer extends EventEmitter {\n // Singleton instance\n private static instance: TwilioAgentPaymentServer | null = null;\n\n /**\n * Static method to get the instance\n */\n public static getInstance(): TwilioAgentPaymentServer {\n if (!TwilioAgentPaymentServer.instance) {\n throw new Error('TwilioAgentPaymentServer not initialized. Call initialize() first.');\n }\n return TwilioAgentPaymentServer.instance;\n }\n \n /**\n * Static method to initialize the instance\n */\n public static initialize(accountSid: string, apiKey: string, apiSecret: string): TwilioAgentPaymentServer {\n if (!TwilioAgentPaymentServer.instance) {\n TwilioAgentPaymentServer.instance = new TwilioAgentPaymentServer(accountSid, apiKey, apiSecret);\n }\n return TwilioAgentPaymentServer.instance;\n }\n\n // Private constructor to prevent direct instantiation\n private constructor(accountSid: string, apiKey: string, apiSecret: string) {\n // Initialization code...\n }\n}\n```\n\n这种方法的好处：\n\n* 确保整个应用程序中只有一个 TwilioAgentPaymentServer 实例\n* 无需通过多个函数传递实例\n* 提供更简洁的 API 和更简单的函数签名\n* 可以更轻松地从代码库中的任何位置访问 TwilioAgentPaymentServer\n\n### 工厂函数模式\n\n工具、提示和资源是使用工厂功能模式实现的：\n\n1. **在工具中**：\n\n ```typescript\n // Example from StartPaymentCaptureTool.ts\n export function startPaymentCaptureTool() {\n // Get the TwilioAgentPaymentServer instance\n const twilioAgentPaymentServer = TwilioAgentPaymentServer.getInstance();\n \n // Create an event emitter for logging\n const emitter = new EventEmitter();\n \n return {\n name: \"startPaymentCapture\",\n description: \"Start a new payment capture session\",\n shape: schema.shape,\n execute: async function execute(params: z.infer, extra: any): Promise {\n // Implementation that calls Twilio API and returns result\n },\n emitter // For attaching event listeners\n }\n }\n ```\n\n2. **在资源中**：\n\n ```typescript\n // Example from PaymentStatusResource.ts\n export function paymentStatusResource() {\n // Get the TwilioAgentPaymentServer instance\n const twilioAgentPaymentServer = TwilioAgentPaymentServer.getInstance();\n \n // Create an event emitter for logging\n const emitter = new EventEmitter();\n \n return {\n name: \"PaymentStatus\",\n template: new ResourceTemplate(\"payment://{callSid}/{paymentSid}/status\", { list: undefined }),\n description: \"Get the current status of a payment session\",\n read: async (uri: URL, variables: Record, extra: any): Promise => {\n // Implementation that retrieves and formats payment status data\n },\n emitter // For attaching event listeners\n };\n }\n ```\n\n3. **在提示中**：\n\n ```typescript\n // Example from a prompt factory function\n export function startCapturePrompt() {\n return {\n name: \"StartCapture\",\n description: \"Prompt for starting the payment capture process\",\n execute: (args: { callSid: string }, extra: RequestHandlerExtra): GetPromptResult | Promise => {\n // Return prompt content\n }\n };\n }\n ```\n\n### 自动发现和注册\n\n服务器使用自动发现机制来查找并注册所有组件：\n\n```typescript\n// In src/utils/autoDiscovery.ts\nexport async function discoverComponents(mcpServer: McpServer) {\n // Get the current directory path\n const basePath: string = path.dirname(fileURLToPath(import.meta.url));\n\n await Promise.all([\n discoverTools(mcpServer, path.join(basePath, '../tools')),\n discoverPrompts(mcpServer, path.join(basePath, '../prompts')),\n discoverResources(mcpServer, path.join(basePath, '../resources'))\n ]);\n}\n```\n\n这种方法：\n\n* 自动查找各自目录中的所有工具、提示和资源\n* 动态导入并注册到 MCP 服务器\n* 无需修改主文件即可轻松添加新组件\n* 减少样板代码并提高可维护性\n\n### 提示中的参数\n\n某些提示可以接受参数，用于自定义提示内容。StartCapturePrompt 就是一个很好的例子：\n\n1. **参数定义**：\n\n ```typescript\n // In the prompt factory function\n return {\n name: \"StartCapture\",\n description: \"Prompt for starting the payment capture process\",\n schema: { callSid: z.string().describe(\"The Twilio Call SID\") }, // Parameter schema\n execute: (args: { callSid: string }, extra: RequestHandlerExtra) => {\n // Implementation\n }\n };\n ```\n\n * schema 属性使用 Zod 定义参数模式\n * 在这种情况下，它需要一个字符串类型的`callSid`参数\n\n2. **提示中的参数使用**：\n\n ```typescript\n execute: (args: { callSid: string }, extra: RequestHandlerExtra): GetPromptResult | Promise => {\n const { callSid } = args;\n\n if (!callSid) {\n throw new Error(\"callSid parameter is required\");\n }\n \n return {\n messages: [\n {\n role: \"assistant\",\n content: {\n type: \"text\",\n text: getStartCapturePromptText(callSid), // Use the parameter in the prompt text\n }\n }\n ]\n };\n }\n ```\n\n * 执行方法接受参数作为其第一个参数\n * 可以验证参数，并自定义提示内容\n * 在这种情况下，callSid 在提示文本中用于提供上下文\n\n这种模式允许提示动态且具有上下文，根据支付流程的当前状态提供定制的指导。\n\n## 可用工具\n\n### 开始支付捕获\n\n为活动呼叫启动付款捕获流程。\n\n参数：\n\n* `callSid` ：当前通话的 Twilio 呼叫 SID\n\n重要提示：StartCapturePrompt.ts 要求用户在 MCP 客户端输入一个调用 SID。这是一个必需参数，如果未提供，提示将会抛出错误。\n\n注意：处理 Twilio 呼叫时，您需要了解正在使用的呼叫 SID。Twilio 支付需要连接到 PSTN 侧呼叫线路。如果应用于 Twilio 客户端，则不会捕获 DTMF 数字。因此，此 MCP 服务器会假定正在使用正确的呼叫线路。通常检查方式如下：\n\n```javascript\n // Pseudo code: direction of the call\n if (event.CallDirection === \"toPSTN\") {\n theCallSid = event.CallSid;\n }\n\n if (event.CallDirection == \"toSIP\") {\n theCallSid = event.ParentCallSid;\n }\n```\n\n返回：\n\n* `paymentSid` ：新付款会话的 Twilio 付款 SID\n\n### 捕获卡号\n\n开始捕获支付卡号。\n\n参数：\n\n* `callSid` ：当前通话的 Twilio 呼叫 SID\n* `paymentSid` ：支付会话的 Twilio 支付 SID\n* `captureType` ：设置为“支付卡号”\n\n返回：\n\n* 卡号捕获操作的状态\n\n### 捕获安全码\n\n开始捕获卡安全码。\n\n参数：\n\n* `callSid` ：当前通话的 Twilio 呼叫 SID\n* `paymentSid` ：支付会话的 Twilio 支付 SID\n* `captureType` ：设置为“安全码”\n\n返回：\n\n* 安全代码捕获操作的状态\n\n### 捕获到期日期\n\n开始捕获卡到期日期。\n\n参数：\n\n* `callSid` ：当前通话的 Twilio 呼叫 SID\n* `paymentSid` ：支付会话的 Twilio 支付 SID\n* `captureType` ：设置为“expiration-date”\n\n返回：\n\n* 到期日期捕获操作的状态\n\n### 完成付款捕获\n\n完成付款捕获会话。\n\n参数：\n\n* `callSid` ：当前通话的 Twilio 呼叫 SID\n* `paymentSid` ：支付会话的 Twilio 支付 SID\n\n返回：\n\n* 付款完成操作的状态\n\n## 可用资源\n\n### 付款：//{callSid}/{paymentSid}/status\n\n获取支付会话的当前状态（以 JSON 对象表示）。此资源提供有关支付捕获流程当前状态的详细信息，包括：\n\n* 付款 SID\n* 支付卡号（屏蔽）\n* 支付卡类型\n* 安全码状态\n* 截止日期\n* 付款确认码\n* 付款结果\n* 支付令牌\n\n## MCP 提示\n\n服务器提供上下文提示，指导 LLM 完成支付流程的每个步骤：\n\n### 开始捕获提示\n\n提供有关如何启动付款捕获流程的指导，包括：\n\n* 询问客户是否准备好提供付款信息的说明\n* 安全处理和标记化的解释\n* 使用 startPaymentCapture 工具的步骤\n* **重要提示**：要求用户从 MCP 客户端输入呼叫 SID，这是必需参数\n\n### 卡号提示\n\n指导LLM如何处理卡号捕获流程，包括：\n\n* 向客户解释所需信息的说明\n* 处理客户问题或疑虑的技巧\n* 使用captureCardNumber工具的步骤\n\n### 安全码提示\n\n提供获取卡片安全码的指导，包括：\n\n* 解释安全码的说明\n* 处理客户问题或疑虑的技巧\n* 使用captureSecurityCode工具的步骤\n\n### 到期日期提示\n\n指导法学硕士获取卡片到期日期，包括：\n\n* 解释所需格式的说明（MM/YY）\n* 处理客户问题或疑虑的技巧\n* 使用captureExpirationDate工具的步骤\n\n### 完成捕获提示\n\n提供完成付款捕获流程的指导，包括：\n\n* 确认已收集所有信息的说明\n* 使用 completePaymentCapture 工具的步骤\n\n### 完成提示\n\n指导法学硕士在付款成功处理后应采取的措施，包括：\n\n* 确认付款成功的说明\n* 对话后续步骤的建议\n\n### 错误提示\n\n提供处理付款过程中错误的指导，包括：\n\n* 向客户解释错误的说明\n* 解决常见问题的建议\n* 重试付款捕获流程的步骤\n\n## 建筑学\n\n该 MCP 服务器实现了增强的架构来处理支付流程：\n\n### 基于事件的架构\n\n服务器使用基于事件的架构，通过 EventEmitter 实现组件之间的通信：\n\n* 每个工具、资源和服务器组件都扩展了 EventEmitter\n* 组件发出用于日志记录和回调的事件\n* 事件监听器将日志转发到 MCP 服务器的日志系统\n\n### 回调处理\n\n服务器使用@deshartman/mcp-status-callback 包来处理来自 Twilio 的异步回调：\n\n* 使用 Ngrok 创建用于接收回调的安全隧道\n* 处理不同支付阶段的回调\n* 根据回调数据更新状态存储\n* 处理错误情况和重新进入的情况\n\n### 状态管理\n\n付款状态通过基于 Map 的商店进行管理：\n\n* statusCallbackMap 存储按付款 SID 索引的付款会话数据\n* 每次回调都会用最新信息更新状态\n* PaymentStatusResource 提供对此状态数据的访问\n\n### MCP 集成\n\n服务器通过以下方式与 MCP 协议集成：\n\n* 工具：使用 Zod 模式定义输入验证\n* 资源：提供对支付状态数据的访问\n* 提示：支付流程每个步骤的上下文指导\n* 日志记录：基于事件的日志转发到 MCP 服务器\n\n## 发展\n\n要构建项目：\n\n```bash\nnpm install\nnpm run build\n```\n\n### 先决条件\n\n* Node.js 18+\n* Express（用于回调处理）\n* Twilio SDK\n* 带有授权令牌的 Ngrok 帐户\n\n### 手动运行服务器\n\n要手动启动服务器进行测试（在 Claude Desktop 之外）：\n\n```bash\n# Run with actual credentials\nnode build/index.js \"your_account_sid_here\" \"your_api_key_here\" \"your_api_secret\"\n\n# Or use the npm script (which uses ts-node for development)\nnpm run dev -- \"your_account_sid_here\" \"your_api_key_here\" \"your_api_secret\"\n```\n\n服务器将启动并等待 MCP 客户端连接。\n\n与 Claude Desktop 一起使用时，Claude 加载配置文件时服务器会自动启动。您无需手动启动它。\n\n## PCI合规性\n\n此服务器通过标记支付卡信息来帮助满足 PCI 合规性。实际的卡数据由 Twilio 处理，绝不会存储在您的系统中。有关 Twilio PCI 合规性的更多信息，请参阅[Twilio 安全支付文档](https://www.twilio.com/docs/voice/tutorials/secure-payment-processing)。\n\n## 执照\n\n麻省理工学院\n\n## MCP 检查器兼容性\n\n将此服务器与 MCP 检查器一起使用时，请注意，所有日志记录均通过 MCP 日志记录功能完成，而不是`console.log()` 。这是有意为之，并且为了与使用 stdout 进行 JSON 通信的 MCP 协议兼容所必需的。\n\n如果您正在扩展此服务器或调试问题：\n\n1. 通过发出 LOG\\_EVENT 事件来使用基于事件的日志系统\n2. 避免使用`console.log()` ，因为它会干扰 MCP 协议在 stdout 上的 JSON 消息\n3. 对于 MCP 上下文之外的调试，可以使用`console.error()`将其输出到 stderr\n\n## 基于事件的日志记录架构\n\n服务器使用基于事件的日志记录架构：\n\n1. **事件发射器**：所有工具和资源类都扩展了 Node.js 的`EventEmitter` ，并发出带有级别和消息数据的“日志”事件。\n\n2. **日志转发**：这些事件由事件监听器捕获并转发到 MCP 服务器的日志系统：\n\n ```javascript\n // Set up event listeners for tool logs\n startPaymentCaptureTool.on(LOG_EVENT, logToMcp);\n captureCardNumberTool.on(LOG_EVENT, logToMcp);\n // ... other tools\n ```\n\n3. **MCP 集成**： `logToMcp`函数将这些事件转换为与 MCP 兼容的日志消息：\n\n ```javascript\n const logToMcp = (data: { level: string, message: string }) => {\n // Only use valid log levels: info, error, debug\n // If level is 'warn', treat it as 'info'\n const mcpLevel = data.level === 'warn' ? 'info' : data.level as \"info\" | \"error\" | \"debug\";\n\n // Send the log message to the MCP server's underlying Server instance\n mcpServer.server.sendLoggingMessage({\n level: mcpLevel,\n data: data.message,\n });\n };\n ```\n\n### 支持的日志级别\n\n服务器支持以下日志级别：\n\n* `info` ：一般信息消息\n* `error` ：错误消息和异常\n* `debug` ：详细调试信息\n* `warn` ：警告信息（为了兼容 MCP，自动转换为“info”）\n\n## 支付回调数据结构\n\n服务器处理来自 Twilio 的两种主要类型的回调数据：\n\n### 初始连接器数据\n\n首次创建支付会话时，Twilio 会发送连接器数据：\n\n```json\n{\n \"PaymentConnector\": \"PGP_MOCK\",\n \"DateCreated\": \"2021-08-10T03:55:53.408Z\",\n \"PaymentMethod\": \"credit-card\",\n \"CallSid\": \"CAzzzzz\",\n \"ChargeAmount\": \"9.99\",\n \"AccountSid\": \"ACxxxxx\",\n \"Sid\": \"PKxxxx\"\n}\n```\n\n### 捕获数据\n\n当获取到支付信息后，Twilio 会发送更新的数据：\n\n```json\n{ \n \"SecurityCode\": \"xxx\",\n \"PaymentCardType\": \"visa\",\n \"Sid\": \"PKxxxx\",\n \"PaymentConfirmationCode\": \"ch_a9dc6297cd1a4fb095e61b1a9cf2dd1d\",\n \"CallSid\": \"CAxxxxx\",\n \"Result\": \"success\",\n \"AccountSid\": \"AC75xxxxxx\",\n \"ProfileId\": \"\",\n \"DateUpdated\": \"2021-08-10T03:58:27.290Z\",\n \"PaymentToken\": \"\",\n \"PaymentMethod\": \"credit-card\",\n \"PaymentCardNumber\": \"xxxxxxxxxxxx1111\",\n \"ExpirationDate\": \"1225\"\n}\n```\n\n服务器将该数据存储在 statusCallbackMap 中，通过付款 SID 进行索引，并通过 PaymentStatusResource 提供该数据。","Chinese","zh-CN","githubUser","locale",{"_71":72,"_73":74,"_13":91,"_98":32,"_99":32,"_100":101,"_104":105,"_128":-5,"_16":129,"_130":131,"_132":133,"_33":34,"_158":118,"_159":-5,"_160":-5,"_161":-5,"_162":-5,"_163":164,"_169":-5,"_140":114,"_170":171,"_174":-5,"_119":175,"_176":177},"addedAt","2025-03-24T17:11:29.325325213Z","argumentsJsonSchema",{"_75":76,"_88":89,"_80":90},"properties",{"_77":78,"_82":83,"_85":86},"CURRENCY",{"_31":79,"_80":81},"Currency for payments (e.g., 'USD', 'EUR')","type","string","TOKEN_TYPE",{"_31":84,"_80":81},"Type of token to use for payments (e.g., 'reusable', 'one-time')","PAYMENT_CONNECTOR",{"_31":87,"_80":81},"Payment connector to use with Twilio","required",[82,77,85],"object",[92,93,94,95,96,97],"category:other","category:communication","environment:network","hosting:remote-capable","language:typescript","license_grade:a","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":36,"_102":103},"url","https://github.com/deshartman/twilio-agent-payments-mcp-server","githubRepository",{"_106":107,"_108":109,"_110":111,"_112":113,"_33":114,"_115":116,"_121":122,"_123":124,"_126":127},"defaultBranch","main","fullName","deshartman/twilio-agent-payments-mcp-server","githubTreeId",113235,"language","TypeScript","twilio-agent-payments-mcp-server","owner",{"_117":118,"_119":120},"login","deshartman","uid","0vi4BhX4V1","recentStargazers",0,"spdxLicense",{"_33":125},"MIT License","stargazers",2,"glamaJson",3526,"inspectable",false,"integrations",[134,144,151],{"_135":136,"_31":142,"_119":143},"brand",{"_137":138,"_33":139,"_140":141},"logoSvgPath","M24 18.588a1.529 1.529 0 01-1.895-.72l-3.45-4.771-.5-.667-4.003 5.444a1.466 1.466 0 01-1.802.708l5.158-6.92-4.798-6.251a1.595 1.595 0 011.9.666l3.576 4.83 3.596-4.81a1.435 1.435 0 011.788-.668L21.708 7.9l-2.522 3.283a.666.666 0 000 .994l4.804 6.412zM.002 11.576l.42-2.075c1.154-4.103 5.858-5.81 9.094-3.27 1.895 1.489 2.368 3.597 2.275 5.973H1.116C.943 16.447 4.005 19.009 7.92 17.7a4.078 4.078 0 002.582-2.876c.207-.666.548-.78 1.174-.588a5.417 5.417 0 01-2.589 3.957 6.272 6.272 0 01-7.306-.933 6.575 6.575 0 01-1.64-3.858c0-.235-.08-.455-.134-.666A88.33 88.33 0 010 11.577zm1.127-.286h9.654c-.06-3.076-2.001-5.258-4.59-5.278-2.882-.04-4.944 2.094-5.071 5.264z","Express","slug","express","Uses Express to handle asynchronous callbacks from Twilio, processing payment stage notifications and updating payment session state.","vc0tq6c1fr",{"_135":145,"_31":149,"_119":150},{"_137":146,"_33":147,"_140":148},"M11.998,24c-0.321,0-0.641-0.084-0.922-0.247l-2.936-1.737c-0.438-0.245-0.224-0.332-0.08-0.383 c0.585-0.203,0.703-0.25,1.328-0.604c0.065-0.037,0.151-0.023,0.218,0.017l2.256,1.339c0.082,0.045,0.197,0.045,0.272,0l8.795-5.076 c0.082-0.047,0.134-0.141,0.134-0.238V6.921c0-0.099-0.053-0.192-0.137-0.242l-8.791-5.072c-0.081-0.047-0.189-0.047-0.271,0 L3.075,6.68C2.99,6.729,2.936,6.825,2.936,6.921v10.15c0,0.097,0.054,0.189,0.139,0.235l2.409,1.392 c1.307,0.654,2.108-0.116,2.108-0.89V7.787c0-0.142,0.114-0.253,0.256-0.253h1.115c0.139,0,0.255,0.112,0.255,0.253v10.021 c0,1.745-0.95,2.745-2.604,2.745c-0.508,0-0.909,0-2.026-0.551L2.28,18.675c-0.57-0.329-0.922-0.945-0.922-1.604V6.921 c0-0.659,0.353-1.275,0.922-1.603l8.795-5.082c0.557-0.315,1.296-0.315,1.848,0l8.794,5.082c0.57,0.329,0.924,0.944,0.924,1.603 v10.15c0,0.659-0.354,1.273-0.924,1.604l-8.794,5.078C12.643,23.916,12.324,24,11.998,24z M19.099,13.993 c0-1.9-1.284-2.406-3.987-2.763c-2.731-0.361-3.009-0.548-3.009-1.187c0-0.528,0.235-1.233,2.258-1.233 c1.807,0,2.473,0.389,2.747,1.607c0.024,0.115,0.129,0.199,0.247,0.199h1.141c0.071,0,0.138-0.031,0.186-0.081 c0.048-0.054,0.074-0.123,0.067-0.196c-0.177-2.098-1.571-3.076-4.388-3.076c-2.508,0-4.004,1.058-4.004,2.833 c0,1.925,1.488,2.457,3.895,2.695c2.88,0.282,3.103,0.703,3.103,1.269c0,0.983-0.789,1.402-2.642,1.402 c-2.327,0-2.839-0.584-3.011-1.742c-0.02-0.124-0.126-0.215-0.253-0.215h-1.137c-0.141,0-0.254,0.112-0.254,0.253 c0,1.482,0.806,3.248,4.655,3.248C17.501,17.007,19.099,15.91,19.099,13.993z","Node.js","node-dot-js","Built on Node.js, allowing the server to maintain in-memory state stores for payment sessions and handle the MCP protocol communication.","kpgjevovet",{"_135":152,"_31":156,"_119":157},{"_137":153,"_33":154,"_140":155},"M12 0C5.381-.008.008 5.352 0 11.971V12c0 6.64 5.359 12 12 12 6.64 0 12-5.36 12-12 0-6.641-5.36-12-12-12zm0 20.801c-4.846.015-8.786-3.904-8.801-8.75V12c-.014-4.846 3.904-8.786 8.75-8.801H12c4.847-.014 8.786 3.904 8.801 8.75V12c.015 4.847-3.904 8.786-8.75 8.801H12zm5.44-11.76c0 1.359-1.12 2.479-2.481 2.479-1.366-.007-2.472-1.113-2.479-2.479 0-1.361 1.12-2.481 2.479-2.481 1.361 0 2.481 1.12 2.481 2.481zm0 5.919c0 1.36-1.12 2.48-2.481 2.48-1.367-.008-2.473-1.114-2.479-2.48 0-1.359 1.12-2.479 2.479-2.479 1.361-.001 2.481 1.12 2.481 2.479zm-5.919 0c0 1.36-1.12 2.48-2.479 2.48-1.368-.007-2.475-1.113-2.481-2.48 0-1.359 1.12-2.479 2.481-2.479 1.358-.001 2.479 1.12 2.479 2.479zm0-5.919c0 1.359-1.12 2.479-2.479 2.479-1.367-.007-2.475-1.112-2.481-2.479 0-1.361 1.12-2.481 2.481-2.481 1.358 0 2.479 1.12 2.479 2.481z","Twilio","twilio","Enables handling agent-assisted payments via the Twilio API, allowing secure processing of payment card information (card number, security code, expiration date) during voice calls, with support for tokenization, payment status tracking, and field re-entry.","3qilocnhcl","namespace","npmPackage","prompts","redditPostForeignId","resources","scores",{"_165":166,"_167":-5,"_168":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms",[172,173],"MACOS","WINDOWS","tools","4mmirsww6y","updatedAt","2025-04-30T21:00:40.345345284Z","meta",[180,183,185,192,195,197,200,203,206,209,212,214,217,220,222,224,226,228,230],{"_181":182},"title","Twilio Agent Payments MCP Server | Glama",{"_184":32,"_33":31},"content",{"_186":187,"_188":189,"_190":191},"href","https://glama.ai/mcp/servers/@deshartman/twilio-agent-payments-mcp-server","rel","canonical","tagName","link",{"_184":34,"_193":194},"property","og:title",{"_184":32,"_193":196},"og:description",{"_184":198,"_193":199},"https://glama.ai/logo.png","og:logo",{"_184":201,"_193":202},"https://glama.ai/mcp/servers/@deshartman/twilio-agent-payments-mcp-server/og-image","og:image",{"_184":204,"_193":205},"630","og:image:height",{"_184":207,"_193":208},"1200","og:image:width",{"_184":210,"_193":211},"website","og:type",{"_184":187,"_193":213},"og:url",{"_184":215,"_193":216},"Glama – MCP Hosting Platform","og:site_name",{"_184":218,"_33":219},"summary_large_image","twitter:card",{"_184":215,"_33":221},"twitter:title",{"_184":32,"_33":223},"twitter:description",{"_184":201,"_33":225},"twitter:image",{"_184":204,"_33":227},"twitter:image:height",{"_184":207,"_33":229},"twitter:image:width",{"_231":232},"script:ld+json",{"_233":234,"_235":236},"@context","http://schema.org","@graph",[237],{"_233":238,"_239":240,"_241":242},"https://schema.org","@type","BreadcrumbList","itemListElement",[243,250,253,257],{"_239":244,"_245":246,"_33":247,"_248":249},"ListItem","item","https://glama.ai/","Glama","position",1,{"_239":244,"_245":251,"_33":252,"_248":127},"https://glama.ai/mcp","MCP",{"_239":244,"_245":254,"_33":255,"_248":256},"https://glama.ai/mcp/servers","Servers",3,{"_239":244,"_245":187,"_33":34,"_248":258},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_68":-5,"_29":262,"_178":283,"_318":-5},{"_71":72,"_73":263,"_13":269,"_98":32,"_99":32,"_100":270,"_104":271,"_128":-5,"_16":129,"_130":131,"_132":274,"_33":34,"_158":118,"_159":-5,"_160":-5,"_161":-5,"_162":-5,"_163":281,"_169":-5,"_140":114,"_170":282,"_174":-5,"_119":175,"_176":177},{"_75":264,"_88":268,"_80":90},{"_77":265,"_82":266,"_85":267},{"_31":79,"_80":81},{"_31":84,"_80":81},{"_31":87,"_80":81},[82,77,85],[92,93,94,95,96,97],{"_35":36,"_102":103},{"_106":107,"_108":109,"_110":111,"_112":113,"_33":114,"_115":272,"_121":122,"_123":273,"_126":127},{"_117":118,"_119":120},{"_33":125},[275,277,279],{"_135":276,"_31":142,"_119":143},{"_137":138,"_33":139,"_140":141},{"_135":278,"_31":149,"_119":150},{"_137":146,"_33":147,"_140":148},{"_135":280,"_31":156,"_119":157},{"_137":153,"_33":154,"_140":155},{"_165":166,"_167":-5,"_168":-5},[172,173],[284,286,288,290,292,293,294,295,296,297,298,299,300,301,302,303,304,305,306],{"_181":285},"Reviews | Twilio Agent Payments MCP Server | Glama",{"_184":287,"_33":31},"Read community reviews and feedback for Twilio Agent Payments MCP Server. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_186":289,"_188":189,"_190":191},"https://glama.ai/mcp/servers/@deshartman/twilio-agent-payments-mcp-server/reviews",{"_184":291,"_193":194},"Reviews | Twilio Agent Payments MCP Server",{"_184":287,"_193":196},{"_184":198,"_193":199},{"_184":201,"_193":202},{"_184":204,"_193":205},{"_184":207,"_193":208},{"_184":210,"_193":211},{"_184":289,"_193":213},{"_184":215,"_193":216},{"_184":218,"_33":219},{"_184":215,"_33":221},{"_184":287,"_33":223},{"_184":201,"_33":225},{"_184":204,"_33":227},{"_184":207,"_33":229},{"_231":307},{"_233":234,"_235":308},[309],{"_233":238,"_239":240,"_241":310},[311,312,313,314,315],{"_239":244,"_245":246,"_33":247,"_248":249},{"_239":244,"_245":251,"_33":252,"_248":127},{"_239":244,"_245":254,"_33":255,"_248":256},{"_239":244,"_245":187,"_33":34,"_248":258},{"_239":244,"_245":289,"_33":316,"_248":317},"Reviews",5,"review","actionData","errors"]

Rate & Review

MCP directory API