twilio-developer-kit

Twilio for AI

Official Twilio Skills and MCP for AI coding agents. Works across Claude Code, Cursor, Codex, and any tool supporting the Agent Skills standard.

Public Beta: Twilio MCP and Twilio Skills are currently available as Public Beta products, and the information contained in this repository is subject to change. This means that some features are not yet implemented and others may be changed before the products are declared as Generally Available. Public Beta products are not covered by the Twilio Support Terms or Twilio Service Level Agreement.

---

Twilio MCP

The Twilio MCP server provides search over Twilio documentation and API specifications. It exposes two tools:

Tool	Description
twilio__search	Search Twilio docs and API operations by natural language query
twilio__retrieve	Fetch full parameter schemas for specific API operations

Endpoint: https://mcp.twilio.com/docs

See mcp/README.md for setup instructions across all supported IDEs. Documentation: https://www.twilio.com/docs/ai/mcp

Feedback

• Questions and feedback: [email protected]
• Issues: GitHub Issues

---

Twilio Skills

Skills are structured packages of procedural knowledge for AI coding agents. They follow a progressive disclosure architecture: your agent sees lightweight metadata for all available skills, loads the relevant skill when a task matches, and drills into reference material on demand — keeping your context window lean while providing deep domain expertise exactly when needed.

What Skills help with

• Product selection: "I need to verify users" — the agent reasons through Twilio Verify vs. custom OTP, whether to add Lookup for fraud scoring, before any code gets written
• Architecture patterns: "Build me an AI voice agent" — the agent asks questions to understand your use case complexity, then recommends the right combination of products (e.g., Conversation Relay + Memory + Conversation Intelligence + TaskRouter)
• What to avoid: Skills carry explicit CANNOT sections that reduce hallucination by documenting hard constraints and common pitfalls

Available skill categories

Type	Purpose	Examples
Setup	Account, auth, and number configuration	twilio-account-setup, twilio-iam-auth-setup
Planner	Use-case qualification and product selection	twilio-identity-verification-advisor, twilio-marketing-promotions-advisor
Product	How to use one Twilio product correctly	twilio-verify-send-otp, twilio-sms-send-message, twilio-sendgrid-email-send
Guardrail	Operational patterns preventing failures	twilio-security-hardening, twilio-reliability-patterns, twilio-compliance-traffic

Covers: SMS, MMS, WhatsApp, RCS, Voice, Verify, SendGrid, Conversations, Messaging Services, Compliance (A2P 10DLC, Toll-Free, STIR/SHAKEN), and more.

Documentation: https://www.twilio.com/docs/ai/skills

Install

Claude Code

# Add the Twilio marketplace and install the plugin (includes Skills + MCP)
/plugin marketplace add twilio/ai
/plugin install twilio-developer-kit@twilio

Skills activate automatically when your prompt matches a covered use case. You can also invoke them directly:

/twilio-verify-send-otp
/twilio-sms-send-message

Cursor

Skills follow the open Agent Skills standard. Cursor auto-discovers them from .agents/skills/ in your workspace:

git clone https://github.com/twilio/ai.git .twilio-ai
cp -r .twilio-ai/skills/ .agents/skills/

Add the MCP server in Cursor Settings > MCP:

{
  "twilio-docs": {
    "type": "http",
    "url": "https://mcp.twilio.com/docs"
  }
}

Codex (OpenAI)

# Add MCP server
codex mcp add twilio-docs --url https://mcp.twilio.com/docs

# Add Skills (user-level, available across all projects)
git clone https://github.com/twilio/ai.git
cp -r ai/skills/ ~/.agents/skills/

Other tools (GitHub Copilot, Gemini CLI, JetBrains, etc.)

Twilio Skills use the open Agent Skills standard (SKILL.md format). Any tool supporting this standard can load them from the skills/ directory in this repo.

For MCP, use the streamable HTTP endpoint: https://mcp.twilio.com/docs

---

Verify it's working

After setup, ask your agent:

"How do I send an SMS with Twilio?"

Your agent should provide guidance on Messaging Services, A2P compliance, error handling, and recommend specific skills for deeper implementation — rather than relying solely on training data.

---

Feedback

• Questions and feedback: [email protected]
• Issues: GitHub Issues

---

Disclaimer