Skip to content
Back to search

mcp

Monorepo providing 1) OpenAPI to MCP Tool generator 2) Exposing all of Twilio's API as MCP Tools

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/twilio-labs--mcp/badge.svg)](/listings/twilio-labs--mcp)

HTML

<a href="/listings/twilio-labs--mcp"><img src="/api/listings/twilio-labs--mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](https://www.twilio.com/docs/iam/api-keys) for information on how to find/create your API Key and Secret.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 83 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center"><img src="https://github.com/twilio-labs/mcp/blob/246f1b1cd1854d1343468af07a2dfa179dc30a16/docs/twilioAlphaLogoLight.png?raw=true#gh-dark-mode-only" height="70" alt="Twilio Alpha"/><img src="https://github.com/twilio-labs/mcp/blob/246f1b1cd1854d1343468af07a2dfa179dc30a16/docs/twilioAlphaLogoDark.png?raw=true#gh-light-mode-only" height="70" alt="Twilio Alpha"/></p>
  2. <h1 align="center">Twilio MCP Monorepo</h1>
  3. This is a monorepo for the Model Context Protocol server that exposes all of Twilio APIs.
  4. ## What is MCP?
  5. 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.
  6. ## Packages
  7. This monorepo contains two main packages:
  8. - [mcp](/packages/mcp) - MCP Server for all of Twilio's Public API
  9. - [openapi-mcp-server](/packages/openapi-mcp-server) - An MCP server that serves the given OpenAPI spec
  10. Each package has its own comprehensive README with detailed documentation:
  11. - [MCP Package Documentation](/packages/mcp/README.md)
  12. - [OpenAPI MCP Server Documentation](/packages/openapi-mcp-server/README.md)
  13. ## Quick Start
  14. The easiest way to get started is by using npx:
  15. ```json
  16. {
  17. "mcpServers": {
  18. "twilio": {
  19. "command": "npx",
  20. "args": [
  21. "-y",
  22. "@twilio-alpha/mcp",
  23. "YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET"
  24. ]
  25. }
  26. }
  27. }
  28. ```
  29. 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.
  30. ## Security Recommendations
  31. 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.
  32. ## Basic Configuration Options
  33. Both packages accept configuration parameters. Here's a brief overview:
  34. - **MCP Server**: Use `--services` and `--tags` to filter which APIs to expose
  35. - **OpenAPI MCP Server**: Use `--apiPath` to specify OpenAPI spec files location
  36. For complete configuration details, refer to the package-specific documentation linked above.
  37. ## Development
  38. ```bash
  39. # Run tests
  40. npm test
  41. # Run linting
  42. npm run lint
  43. # Fix linting issues
  44. npm run lint:fix
  45. ```
  46. ## Troubleshooting Common Issues
  47. - **Context Size Limitations**: Due to LLM context limits, load specific APIs using `--services` or `--tags`
  48. - **Authentication Issues**: Verify your Twilio API credentials format and permissions
  49. - **API Versioning**: Check you're using the correct API version (v1, v2, v3) for your needs
  50. For detailed troubleshooting guidance, see the package-specific documentation.
  51. ## Contributing
  52. Contributions are welcome! Please feel free to submit a Pull Request.
  53. ## License
  54. This project is licensed under the ISC License - see the LICENSE file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.