io.github.codespar/mcp-whatsapp-cloud
NPM · @CODESPAR/MCP-WHATSAPP-CLOUD · SCANNED AUG 4
MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API
Available components
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 42 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability71
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 1955 tokens (~88/item across 22 items; 22 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management30
- Stability observed for 9 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
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-whatsapp-cloud
claude mcp add codespar-mcp-whatsapp-cloud -- npx -y @codespar/mcp-whatsapp-cloud
codex mcp add codespar-mcp-whatsapp-cloud -- npx -y @codespar/mcp-whatsapp-cloud
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"codespar-mcp-whatsapp-cloud": {
"type": "local",
"command": [
"npx",
"-y",
"@codespar/mcp-whatsapp-cloud"
],
"enabled": true
}
}
} openclaw mcp add codespar-mcp-whatsapp-cloud --command npx --arg -y --arg @codespar/mcp-whatsapp-cloud
mcp_servers:
codespar-mcp-whatsapp-cloud:
command: "npx"
args: ["-y", "@codespar/mcp-whatsapp-cloud"] {
"mcpServers": {
"codespar-mcp-whatsapp-cloud": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-whatsapp-cloud"
]
}
}
} 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.
- 4 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.
- 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
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Schema quality: unverified → good ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Licence: MIT functional
- 1 Aug 26 −1
- Malware scan: unverified → pass ▲ security
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified 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.
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 4 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.
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.
create_template ~125
Submit a new template for Meta review. Templates become usable only after approval (usually minutes to hours).
| Name | Type | Req | Description |
|---|---|---|---|
| allow_category_change | boolean | — | Let Meta re-categorize if needed (default true recommended) |
| category | string | yes | Template category |
| components | array | yes | Array of components: HEADER, BODY, FOOTER, BUTTONS. See Cloud API template docs. |
| language | string | yes | BCP-47 language tag (e.g. en_US, pt_BR) |
| name | string | yes | Template name (lowercase, underscores, unique on WABA) |
No output schema declared.
No examples provided.
delete_media ~28
Delete an uploaded media asset by id.
| Name | Type | Req | Description |
|---|---|---|---|
| media_id | string | yes | Media id to delete |
No output schema declared.
No examples provided.
delete_template ~71
Delete a message template from the WABA by name. Optionally scope by hsm_id when two templates share a name across languages.
| Name | Type | Req | Description |
|---|---|---|---|
| hsm_id | string | — | Optional template id (when multiple languages share a name and only one should be deleted) |
| name | string | yes | Template name to delete |
No output schema declared.
No examples provided.
get_business_profile ~63
Read the WhatsApp business profile (about, description, email, websites, vertical, address) for the configured phone number.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | — | Comma-separated field list. Default: about,address,description,email,profile_picture_url,websites,vertical |
No output schema declared.
No examples provided.
list_phone_numbers ~47
List all phone numbers registered under the WhatsApp Business Account, including display name, quality rating, and verification status.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Max results per page (default 25) |
No output schema declared.
No examples provided.
list_templates ~79
List message templates on the WhatsApp Business Account. Supports optional paging and name filter.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Max templates per page (default 25) |
| name | string | — | Filter by exact template name |
| status | string | — | Filter by status (APPROVED, PENDING, REJECTED, PAUSED, DISABLED) |
No output schema declared.
No examples provided.
mark_message_as_read ~55
Mark an incoming message as read so the sender sees the blue double-check. Uses the wamid from the inbound webhook.
| Name | Type | Req | Description |
|---|---|---|---|
| message_id | string | yes | Inbound message id (wamid.XXX) from the webhook |
No output schema declared.
No examples provided.
request_verification_code ~74
Request Meta to send a verification code to the configured phone number via SMS or voice. Use before verify_code.
| Name | Type | Req | Description |
|---|---|---|---|
| code_method | string | yes | Delivery method for the verification code |
| language | string | yes | BCP-47 language tag for the voice/SMS copy (e.g. en_US, pt_BR) |
No output schema declared.
No examples provided.
retrieve_media_url ~51
Resolve a media_id to a short-lived downloadable URL. The URL itself still requires the Bearer token to fetch.
| Name | Type | Req | Description |
|---|---|---|---|
| media_id | string | yes | Media id returned by upload_media or received in a webhook |
No output schema declared.
No examples provided.
send_contacts_message ~84
Send one or more contact cards (vCard-like). Each contact includes name and at least one of phones, emails, addresses, urls, or org.
| Name | Type | Req | Description |
|---|---|---|---|
| contacts | array | yes | Array of contact objects per Cloud API spec (name, phones, emails, addresses, org, urls, birthday). |
| to | string | yes | Recipient phone number in E.164 without + |
No output schema declared.
No examples provided.
send_interactive_cta_url ~122
Send an interactive message with a single CTA URL button. Opens the URL when the recipient taps it. Available without template approval inside the 24h window.
| Name | Type | Req | Description |
|---|---|---|---|
| body_text | string | yes | Main body text |
| button_text | string | yes | Label shown on the CTA button (max 20 chars) |
| footer_text | string | — | Optional footer text |
| header_text | string | — | Optional header text |
| to | string | yes | Recipient phone number in E.164 without + |
| url | string | yes | HTTPS URL the button opens |
No output schema declared.
No examples provided.
send_interactive_flow ~190
Send a WhatsApp Flow message. Flows are Meta's structured UI experiences (forms, appointment booking, etc.) rendered inside WhatsApp.
| Name | Type | Req | Description |
|---|---|---|---|
| body_text | string | yes | Body text above the CTA |
| flow_action | string | — | Flow action type (default navigate) |
| flow_action_payload | object | — | Optional action payload: { screen, data }. Required for navigate. |
| flow_cta | string | yes | Label on the button that opens the flow (max 20 chars) |
| flow_id | string | yes | ID of the approved Flow |
| flow_token | string | yes | Opaque token your server correlates with this send |
| footer_text | string | — | Optional footer text |
| header_text | string | — | Optional header text |
| mode | string | — | Flow mode. Use draft while testing. |
| to | string | yes | Recipient phone number in E.164 without + |
No output schema declared.
No examples provided.
send_interactive_message ~103
Send an interactive message (reply buttons or list). Supply a fully-formed `interactive` object per Cloud API spec.
| Name | Type | Req | Description |
|---|---|---|---|
| interactive | object | yes | Interactive payload. For buttons: { type: 'button', body: { text }, action: { buttons: [...] } }. For list: { type: 'list', body: { text }, action: { button, sections } }. |
| to | string | yes | Recipient phone number in E.164 without + |
No output schema declared.
No examples provided.
send_location_message ~73
Send a location pin with latitude/longitude and optional name/address.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | — | Optional location address |
| latitude | number | yes | Latitude |
| longitude | number | yes | Longitude |
| name | string | — | Optional location name |
| to | string | yes | Recipient phone number in E.164 without + |
No output schema declared.
No examples provided.
send_media_message ~130
Send an image, video, document, or audio. Supply either `link` (public URL) or `id` (media_id from upload_media).
| Name | Type | Req | Description |
|---|---|---|---|
| caption | string | — | Optional caption (image, video, document only) |
| filename | string | — | Optional filename (document only) |
| id | string | — | Uploaded media_id from upload_media. Use this OR link. |
| link | string | — | Public HTTPS URL of the media. Use this OR id. |
| media_type | string | yes | Kind of media |
| to | string | yes | Recipient phone number in E.164 without + |
No output schema declared.
No examples provided.
send_reaction_message ~81
Send an emoji reaction on a previously received/sent message. Pass empty string for `emoji` to clear a reaction.
| Name | Type | Req | Description |
|---|---|---|---|
| emoji | string | yes | Single unicode emoji. Empty string clears the reaction. |
| message_id | string | yes | wamid of the message being reacted to |
| to | string | yes | Recipient phone number in E.164 without + |
No output schema declared.
No examples provided.
send_template_message ~113
Send an approved message template. Required for business-initiated conversations. Templates must be pre-approved by Meta via create_template.
| Name | Type | Req | Description |
|---|---|---|---|
| components | array | — | Template component parameters (header, body, button). See Cloud API docs for shape. |
| language_code | string | yes | BCP-47 language tag (e.g. en_US, pt_BR, es_MX) |
| template_name | string | yes | Exact name of the approved template |
| to | string | yes | Recipient phone number in E.164 without + |
No output schema declared.
No examples provided.
send_text_message ~100
Send a plain text message. For business-initiated conversations outside the 24h customer-service window, use send_template_message instead.
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | yes | Message text (UTF-8, up to 4096 chars) |
| preview_url | boolean | — | Enable URL preview for links in body (default false) |
| to | string | yes | Recipient phone number in E.164 without + (e.g. 5511999999999) |
No output schema declared.
No examples provided.
send_typing_indicator ~58
Show a typing indicator on a received message. Also marks the message as read. Indicator auto-clears after ~25s or when you reply.
| Name | Type | Req | Description |
|---|---|---|---|
| message_id | string | yes | wamid of the inbound message to show the indicator on |
No output schema declared.
No examples provided.
update_business_profile ~104
Update the business profile on the configured phone number. Supply only the fields you want to change.
| Name | Type | Req | Description |
|---|---|---|---|
| about | string | — | About text (max 139 chars) |
| address | string | — | Physical address |
| description | string | — | Business description |
| string | — | Contact email | |
| vertical | string | — | Business vertical (e.g. RETAIL, EDU, HEALTH, FINANCE, OTHER) |
| websites | array | — | Up to two URLs |
No output schema declared.
No examples provided.
upload_media ~93
Upload a media file and get back a media_id reusable in send_media_message. Multipart POST to /{phone_number_id}/media.
| Name | Type | Req | Description |
|---|---|---|---|
| file_base64 | string | yes | File contents, base64-encoded |
| filename | string | yes | Filename (used for display and extension inference) |
| mime_type | string | yes | MIME type (e.g. image/jpeg, video/mp4, application/pdf, audio/ogg) |
No output schema declared.
No examples provided.
verify_code ~44
Submit the verification code received via SMS/voice after request_verification_code. Completes registration.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | Verification code received (digits only, strip dashes) |
No output schema declared.
No examples provided.