twilio-labs/mcp

トゥイリオ MCP モノレポ

これはModel Context Protocolサーバー用のモノリポジトリで、Twilio APIをすべて公開しています。

MCPとは何か?

モデルコンテキストプロトコル(MCP)は、AIツールやサービス間でモデルコンテキスト情報を交換するためのプロトコルです。この実装により、TwilioのAPIをMCPプロトコルをサポートするAIアシスタントやその他のツールに公開することが可能になります。

荷物

このモノリポジトリには主に2つのパッケージが含まれています:

• mcp - Twilioの公開APIすべてを扱うMCPサーバー
• openAPI-mcp-server - 指定されたOpenAPI仕様に対応するMCPサーバー

各パッケージには詳細なドキュメントを含む包括的なREADMEがあります:

• MCPパッケージドキュメント
• OpenAPI MCPサーバードキュメント

クイックスタート

始める最も簡単な方法は、npxを使うことです:

APIキーとシークレットの見つけ方や作成方法については、Twilio API Keysのドキュメントをご覧ください。

セキュリティ推奨事項

Twilioデータへの信頼できないシステムへの侵入防止のため、ETIチームはTwilio MCPサーバーの利用者に対し、公式サーバーと並行してコミュニティMCPサーバーの設置や運用を避けるよう推奨しています。

Twilio MCP Monorepo

This is a monorepo for the Model Context Protocol server that exposes all of Twilio APIs.

What is MCP?

The Model Context Protocol (MCP) is a protocol for exchanging model context information between AI tools and services. This implementation allows you to expose Twilio’s APIs to AI assistants and other tools that support the MCP protocol.

Packages

This monorepo contains two main packages:

• mcp - MCP Server for all of Twilio’s Public API
• openapi-mcp-server - An MCP server that serves the given OpenAPI spec

Each package has its own comprehensive README with detailed documentation:

• MCP Package Documentation
• OpenAPI MCP Server Documentation

Quick Start

The easiest way to get started is by using npx:

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp",
        "YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET"
      ]
    }
  }
}

Visit Twilio API Keys docs for information on how to find/create your API Key and Secret.

Security Recommendations

To guard against injection attacks that may allow untrusted systems access to your Twilio data, the ETI team advises users of Twilio MCP servers to avoid installing or running any community MCP servers alongside our official ones. Doing so helps ensure that only trusted MCP servers have access to tools interacting with your Twilio account, reducing the risk of unauthorized data access.

Basic Configuration Options

Both packages accept configuration parameters. Here’s a brief overview:

• MCP Server: Use --services and --tags to filter which APIs to expose
• OpenAPI MCP Server: Use --apiPath to specify OpenAPI spec files location

For complete configuration details, refer to the package-specific documentation linked above.

Development

# Run tests
npm test

# Run linting
npm run lint

# Fix linting issues
npm run lint:fix

Troubleshooting Common Issues

• Context Size Limitations: Due to LLM context limits, load specific APIs using --services or --tags
• Authentication Issues: Verify your Twilio API credentials format and permissions
• API Versioning: Check you’re using the correct API version (v1, v2, v3) for your needs

For detailed troubleshooting guidance, see the package-specific documentation.

Contributing