https://github.com/twilio-labs/mcp
Monorepo providing 1) OpenAPI to MCP Tool generator 2) Exposing all of Twilio's API as MCP Tools
https://github.com/twilio-labs/mcp
ai mcp openapi openapi-generator openapi3 twilio-api twilio-mcp
Last synced: 3 months ago
JSON representation
Monorepo providing 1) OpenAPI to MCP Tool generator 2) Exposing all of Twilio's API as MCP Tools
- Host: GitHub
- URL: https://github.com/twilio-labs/mcp
- Owner: twilio-labs
- License: mit
- Created: 2025-03-24T18:55:50.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-04-04T20:38:40.000Z (3 months ago)
- Last Synced: 2025-04-04T21:32:47.318Z (3 months ago)
- Topics: ai, mcp, openapi, openapi-generator, openapi3, twilio-api, twilio-mcp
- Language: TypeScript
- Homepage: https://twilioalpha.com/mcp
- Size: 307 KB
- Stars: 7
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - Twilio - Interact with [Twilio](https://www.twilio.com/en-us) APIs to send messages, manage phone numbers, configure your account, and more. (Official Servers)
- mcp-index - Twilio MCP Monorepo - Integrate and interact with Twilio services directly through the Model Context Protocol, enabling AI assistants to access Twilio APIs seamlessly. This implementation enhances the capabilities of AI applications by allowing communication with Twilio's messaging, voice, and other communication services. (APIs and HTTP Requests)
README
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](/packages/mcp) - MCP Server for all of Twilio's Public API
- [openapi-mcp-server](/packages/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](/packages/mcp/README.md)
- [OpenAPI MCP Server Documentation](/packages/openapi-mcp-server/README.md)
## Quick Start
The easiest way to get started is by using npx:
```json
{
"mcpServers": {
"twilio": {
"command": "npx",
"args": [
"-y",
"@twilio-alpha/mcp",
"YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET"
]
}
}
}
```
Visit [Twilio API Keys docs](https://www.twilio.com/docs/iam/api-keys) for information on how to find/create your API Key and Secret.
## 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
```bash
# 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
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the ISC License - see the LICENSE file for details.