Twilio MCP · Twilio

{
  "name": "twilio__retrieve",
  "description": "Fetch full parameter schemas and response details for one or more Twilio API operations or documentation articles. Use this after twilio__search to get the complete request body fields, path/query parameters, response schema, and curator guidance needed to actually call the API. Pass the id values exactly as returned by twilio__search.",
  "inputSchema": {
    "properties": {
      "fields": {
        "description": "Optional. Limit which top-level fields are returned for each result to reduce payload size. Omit to receive the full spec. For API operations, 'request_body' returns request parameters and body schema; 'response_fields' returns the response schema. Identity fields (api, method, path, operation_id) are always included. All other fields — including intent, summary, description, product, version, and response_schema — are excluded when fields is set. Use twilio__search first to get intent and summary; only use fields here when you need the raw parameter or response schema.",
        "items": {
          "enum": [
            "request_body",
            "response_fields"
          ],
          "type": "string"
        },
        "maxItems": 2,
        "minItems": 1,
        "type": "array"
      },
      "ids": {
        "description": "One or more id values (format: 'op::{api}::{operation_id}') copied verbatim from twilio__search results — do not construct or guess IDs. Only call this tool after calling twilio__search and receiving results. Pass multiple ids to batch-fetch related operations in one call.",
        "items": {
          "type": "string"
        },
        "maxItems": 10,
        "minItems": 1,
        "type": "array"
      }
    },
    "required": [
      "ids"
    ],
    "type": "object"
  }
}

{
  "name": "twilio__search",
  "description": "Search Twilio documentation and API operations by natural language query. Use source=\"docs\" for conceptual guides and setup questions, source=\"api\" for finding specific API endpoints and operations, or source=\"all\" (default) when unsure. Returns ranked documentation snippets and/or API operation summaries. Use twilio__retrieve with an id from API results to get full parameter schemas.",
  "inputSchema": {
    "properties": {
      "limit": {
        "default": 5,
        "description": "Maximum number of results to return. Default 5, max 10. Increase only when you need broader coverage.",
        "maximum": 10,
        "minimum": 1,
        "type": "integer"
      },
      "product": {
        "description": "Optional. Restrict API results to a specific Twilio product. Only applies when source=\"api\" or source=\"all\". Use \"api_v2010\" for the core Twilio communications REST API (calls, SMS/MMS, phone numbers, conferences, recordings).",
        "enum": [
          "accounts",
          "api_v2010",
          "bulkexports",
          "chat",
          "content",
          "conversations",
          "events",
          "flex",
          "flex-api",
          "frontline",
          "iam",
          "iam_organizations",
          "iam_scim",
          "insights",
          "intelligence",
          "ip_messaging",
          "knowledge",
          "lookups",
          "marketplace",
          "memory",
          "messaging",
          "monitor",
          "notify",
          "numbers",
          "oauth",
          "preview",
          "pricing",
          "proxy",
          "routes",
          "sendgrid",
          "serverless",
          "studio",
          "supersim",
          "sync",
          "taskrouter",
          "trunking",
          "trusthub",
          "tsg",
          "verify",
          "video",
          "voice",
          "wireless"
        ],
        "type": "string"
      },
      "query": {
        "description": "Natural language question or description of what you want to do. Be specific — 'how to set up ConversationRelay' or 'send an SMS message' work better than 'relay' or 'messaging'.",
        "maxLength": 200,
        "minLength": 3,
        "type": "string"
      },
      "source": {
        "default": "all",
        "description": "Use \"docs\" for conceptual guides, tutorials, and setup questions. Use \"api\" for finding specific API endpoints, operations, and parameters — preferred for coding tasks. Use \"all\" when unsure (default). \"all\" fires both searches in parallel and interleaves results by rank.",
        "enum": [
          "docs",
          "api",
          "all"
        ],
        "type": "string"
      },
      "topics": {
        "description": "Optional. Restrict doc search to specific sources. Omit to search twilio_docs (default) when you don't know. Only applies when source=\"docs\" or source=\"all\".\n- twilio_docs: API references, error codes, TwiML, SDK docs, tutorials (twilio.com/docs)\n- support_docs: troubleshooting and account support (help.twilio.com)\n- twilio_com: Twilio marketing and product pages\n- twilio_customers: customer stories and case studies\n- twilio_org: Twilio.org social impact content\n- sendgrid: SendGrid product documentation\n- sendgrid_support: SendGrid support articles\n- segment: Segment CDP documentation",
        "items": {
          "enum": [
            "twilio_docs",
            "support_docs",
            "twilio_com",
            "twilio_customers",
            "twilio_org",
            "sendgrid",
            "sendgrid_support",
            "segment"
          ],
          "type": "string"
        },
        "maxItems": 4,
        "minItems": 1,
        "type": "array"
      },
      "version": {
        "description": "Optional. Omit for latest version only, \"any\" for any version, or a specific version e.g. \"v2\". Requires product to also be set when pinning to a specific version.",
        "type": "string"
      }
    },
    "required": [
      "query"
    ],
    "type": "object"
  }
}