io.github.codespar/mcp-twilio

NPM · @CODESPAR/MCP-TWILIO · SCANNED AUG 3

MCP server for Twilio — global SMS, WhatsApp, Voice, Verify, and Lookup across 180+ countries

Available components

+23 this week 69 69 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security86

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 41 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability76

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 2401 tokens (~109/item across 22 items; 22 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @codespar/mcp-twilio

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add codespar-mcp-twilio -- npx -y @codespar/mcp-twilio

# add to Codex CLI

codex mcp add codespar-mcp-twilio -- npx -y @codespar/mcp-twilio

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "codespar-mcp-twilio": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@codespar/mcp-twilio"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add codespar-mcp-twilio --command npx --arg -y --arg @codespar/mcp-twilio

# ~/.hermes/config.yaml

mcp_servers:
  codespar-mcp-twilio:
    command: "npx"
    args: ["-y", "@codespar/mcp-twilio"]

// mcp.json

{
  "mcpServers": {
    "codespar-mcp-twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-twilio"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
2 Aug 26 +47
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Licence: MIT functional
31 Jul 26 −25
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
27 Jul 26 46

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@codespar/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 22 exposed · ~2,334 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

add_conversation_participant ~153

Add a participant to a Conversation. For SMS / WhatsApp, pass MessagingBinding.Address (+E164 or whatsapp:+E164) + MessagingBinding.ProxyAddress (your Twilio number). For chat participants, pass Identity.

Input Output Examples

Name	Type	Req	Description
Attributes	string	—	JSON string of custom participant attributes
ConversationSid	string	yes	Conversation SID (CH...) or UniqueName
Identity	string	—	Chat identity (use for in-app chat participants)
MessagingBinding.Address	string	—	Participant's address: +E164 for SMS, whatsapp:+E164 for WhatsApp
MessagingBinding.ProxyAddress	string	—	Your Twilio number the participant messages with (E.164 or whatsapp:+E164)

No output schema declared.

No examples provided.

buy_phone_number ~138

Provision a new phone number. Supply either a specific `PhoneNumber` (from AvailablePhoneNumbers search) or an `AreaCode` to let Twilio pick one.

Input Output Examples

Name	Type	Req	Description
AreaCode	string	—	Area code — Twilio picks any available number in it
FriendlyName	string	—	Friendly label
PhoneNumber	string	—	Exact E.164 number to buy (from AvailablePhoneNumbers search)
SmsUrl	string	—	TwiML URL for incoming SMS
StatusCallback	string	—	Webhook URL for number status events
VoiceUrl	string	—	TwiML URL for incoming calls

No output schema declared.

No examples provided.

check_verification ~67

Check a Verify (2FA) code against a Service SID. Returns status=approved when the code matches.

Input Output Examples

Name	Type	Req	Description
Code	string	yes	Code the user entered
ServiceSid	string	yes	Verify Service SID (VA...)
To	string	yes	Destination that received the code

No output schema declared.

No examples provided.

create_conversation ~105

Create a Twilio Conversation. Conversations host multi-channel (SMS / WhatsApp / chat) threads with server-side history.

Input Output Examples

Name	Type	Req	Description
Attributes	string	—	JSON string of custom attributes stored on the conversation
FriendlyName	string	—	Human-readable label for the conversation
MessagingServiceSid	string	—	Messaging Service SID (MG...) used for outbound SMS/WhatsApp in this conversation
UniqueName	string	—	Developer-defined unique identifier (alternative addressable key)

No output schema declared.

No examples provided.

create_taskrouter_task ~152

Create a TaskRouter Task on a Workspace. TaskRouter routes work (calls, chats, tickets) to eligible Workers based on attributes.

Input Output Examples

Name	Type	Req	Description
Attributes	string	—	JSON string of task attributes used for routing (e.g. {"selected_language":"pt-br"})
Priority	number	—	Priority (higher = more urgent)
TaskChannel	string	—	Task channel unique_name or SID (e.g. voice, chat, sms, default)
Timeout	number	—	Seconds before the task times out (default 86400)
WorkflowSid	string	—	Workflow SID (WW...) that decides how this task is routed
WorkspaceSid	string	yes	TaskRouter Workspace SID (WS...)

No output schema declared.

No examples provided.

create_verify_service ~105

Create a Verify Service (VA...). A service groups verification attempts and holds per-service config (code length, friendly name).

Input Output Examples

Name	Type	Req	Description
CodeLength	number	—	OTP code length, 4-10 (default 6)
DefaultTemplateSid	string	—	Default message template SID
FriendlyName	string	yes	Human-readable name for the service (e.g. your app name)
LookupEnabled	boolean	—	Run Lookup on targets before sending (blocks invalid numbers)

No output schema declared.

No examples provided.

delete_message ~27

Delete a message from history. Irreversible.

Input Output Examples

Name	Type	Req	Description
Sid	string	yes	Message SID

No output schema declared.

No examples provided.

execute_studio_flow ~110

Trigger a Studio Flow Execution for a contact. Studio flows are visual IVR / workflow builders — this kicks one off for a specific To/From pair.

Input Output Examples

Name	Type	Req	Description
FlowSid	string	yes	Studio Flow SID (FW...)
From	string	yes	Your Twilio number (E.164 or whatsapp:+E164)
Parameters	string	—	JSON string of variables injected into the flow's execution context
To	string	yes	Contact address (E.164 or whatsapp:+E164)

No output schema declared.

No examples provided.

get_call ~27

Retrieve a call resource by SID (CA...).

Input Output Examples

Name	Type	Req	Description
Sid	string	yes	Call SID

No output schema declared.

No examples provided.

get_message ~30

Retrieve a message resource by SID (SM... or MM...).

Input Output Examples

Name	Type	Req	Description
Sid	string	yes	Message SID

No output schema declared.

No examples provided.

list_conversations ~98

List Conversations. Returns a paginated list; pass PageSize to cap.

Input Output Examples

Name	Type	Req	Description
EndDate	string	—	Only include conversations created on/before this ISO-8601 date
PageSize	number	—	Max rows per page (default 50, max 1000)
StartDate	string	—	Only include conversations created on/after this ISO-8601 date
State	string	—	Filter by conversation state

No output schema declared.

No examples provided.

list_incoming_numbers ~82

List Twilio-provisioned phone numbers on this account. Filter by PhoneNumber (partial), FriendlyName, or Beta.

Input Output Examples

Name	Type	Req	Description
FriendlyName	string	—	Filter by friendly name
PageSize	number	—	Max rows per page (default 50, max 1000)
PhoneNumber	string	—	Filter by partial phone number match

No output schema declared.

No examples provided.

list_messages ~148

List messages with optional filters. Returns Twilio's paginated list; pass PageSize to cap.

Input Output Examples

Name	Type	Req	Description
DateSent	string	—	Filter by exact send date (YYYY-MM-DD). Use DateSentAfter / DateSentBefore for ranges.
DateSentAfter	string	—	Return messages sent on/after this date (YYYY-MM-DD)
DateSentBefore	string	—	Return messages sent on/before this date (YYYY-MM-DD)
From	string	—	Filter by sender
PageSize	number	—	Max rows per page (default 50, max 1000)
To	string	—	Filter by destination (E.164 or whatsapp:+E164)

No output schema declared.

No examples provided.

list_messaging_services ~50

List Messaging Services (MG...). A Messaging Service bundles sender pools, templates, and routing rules.

Input Output Examples

Name	Type	Req	Description
PageSize	number	—	Max rows per page (default 50, max 1000)

No output schema declared.

No examples provided.

list_recordings ~119

List call recordings on this account. Optionally filter by CallSid, or by DateCreated range. Returns Twilio's paginated list.

Input Output Examples

Name	Type	Req	Description
CallSid	string	—	Restrict to recordings produced by this Call SID (CA...)
DateCreatedAfter	string	—	Return recordings created on/after this date (YYYY-MM-DD)
DateCreatedBefore	string	—	Return recordings created on/before this date (YYYY-MM-DD)
PageSize	number	—	Max rows per page (default 50, max 1000)

No output schema declared.

No examples provided.

list_taskrouter_workers ~129

List Workers on a TaskRouter Workspace. Optionally filter by ActivityName, Available, or TargetWorkersExpression.

Input Output Examples

Name	Type	Req	Description
ActivityName	string	—	Filter by activity name (e.g. Available, Idle, Offline)
Available	string	—	Filter by availability: 'true' or 'false'
PageSize	number	—	Max rows per page (default 50, max 1000)
TargetWorkersExpression	string	—	TaskRouter expression to filter workers (e.g. languages HAS "pt-br")
WorkspaceSid	string	yes	TaskRouter Workspace SID (WS...)

No output schema declared.

No examples provided.

lookup_phone ~127

Validate and normalize a phone number via Lookups v2. Optional `Fields` lets you request carrier info, line_type_intelligence, caller_name, identity_match, etc.

Input Output Examples

Name	Type	Req	Description
CountryCode	string	—	ISO-3166 alpha-2. Required only if PhoneNumber is not in E.164.
Fields	string	—	Comma-separated list of add-ons (e.g. `line_type_intelligence,caller_name`). Billed per field.
PhoneNumber	string	yes	Number to look up (E.164 recommended; Lookups v2 will format if possible)

No output schema declared.

No examples provided.

make_call ~136

Place an outbound voice call. Twilio fetches TwiML from `Url` on connect to drive the call.

Input Output Examples

Name	Type	Req	Description
From	string	yes	Twilio-provisioned caller ID in E.164
Method	string	—	HTTP method Twilio uses to fetch Url (default POST)
StatusCallback	string	—	Webhook URL for call-status events
StatusCallbackEvent	array	—	Events to subscribe to: initiated, ringing, answered, completed
To	string	yes	Destination number in E.164
Url	string	yes	HTTP(S) URL returning TwiML that drives the call

No output schema declared.

No examples provided.

send_conversation_message ~114

Post a message into a Conversation. Fanned out to all participants via their channel (SMS / WhatsApp / chat).

Input Output Examples

Name	Type	Req	Description
Attributes	string	—	JSON string of custom message attributes
Author	string	—	Identity of the author (defaults to `system` if omitted)
Body	string	—	Message text (UTF-8)
ConversationSid	string	yes	Conversation SID (CH...) or UniqueName
MediaSid	string	—	Media SID (ME...) from a prior MCS upload

No output schema declared.

No examples provided.

send_message ~223

Send an SMS or WhatsApp message. For WhatsApp, prefix `To` (and `From`) with `whatsapp:+E164`. Supply either `From` (a Twilio phone number) OR `MessagingServiceSid` (a Messaging Service). If neither is given, falls back to env TWILIO_MESSAGING_SERVICE_SID.

Input Output Examples

Name	Type	Req	Description
Body	string	yes	Message text (UTF-8)
From	string	—	Twilio phone number in E.164, or `whatsapp:+E164` for WhatsApp. Omit if using MessagingServiceSid.
MediaUrl	array	—	Optional list of media URLs (MMS / WhatsApp media)
MessagingServiceSid	string	—	Messaging Service SID (MG...). Overrides env default. Omit if using From.
StatusCallback	string	—	Webhook URL Twilio calls on delivery-status transitions
To	string	yes	Destination in E.164 (e.g. +5511999999999) or `whatsapp:+E164` for WhatsApp

No output schema declared.

No examples provided.

start_verification ~100

Start a Verify (2FA) challenge. Sends a one-time code to `To` via the chosen channel. Requires a Verify Service SID (VA...).

Input Output Examples

Name	Type	Req	Description
Channel	string	yes	Delivery channel
Locale	string	—	Message locale (e.g. pt-br, en, es)
ServiceSid	string	yes	Verify Service SID (VA...)
To	string	yes	Destination in E.164 (or email for email channel)

No output schema declared.

No examples provided.

update_call ~94

Modify an in-progress call. Set Status='completed' to hang up, or pass a new Url to redirect the call to fresh TwiML.

Input Output Examples

Name	Type	Req	Description
Method	string	—	HTTP method for the new Url
Sid	string	yes	Call SID
Status	string	—	canceled (before answered) or completed (hang up)
Url	string	—	New TwiML URL — redirects the live call

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug