WasapFlow Bridge

Official WhatsApp Business API for your own CRM or SaaS: docs, numbers, messages, webhooks.

Should I use this

Quality & Safety

A
Description quality
94%
Schema completeness
84%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (3)

  • LOWTool 'bridge_number_status' description lacks action verbin bridge_number_status
  • LOWTool 'bridge_retry_webhooks' description lacks action verbin bridge_retry_webhooks
  • LOWTool 'bridge_usage' description lacks action verbin bridge_usage

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,514Tokens (tool definitions)
~1.1 KBTypical response size
Moderate attention impact (1.96% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "bridge": {
      "url": "https://officialapi.wasapflow.com/bridge/mcp"
    }
  }
}

Remote endpoints

https://officialapi.wasapflow.com/bridge/mcpstreamable-http

What it can do

Tool inventory

Tools (16)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢bridge_get_started

Step-by-step plan to add the official WhatsApp Business API to the user's own CRM/SaaS with WasapFlow Bridge: account, keys, webhook URL, Connect WhatsApp button inside the user's own system, first message. Call this first when someone wants to build or connect WhatsApp. No partner key needed.

Input Schema

{
  "type": "object",
  "properties": {}
}
🟢bridge_docs_search(query)

Search the WasapFlow Bridge API reference, partner guide and changelog. Returns matching sections with a preview. Use before writing integration code. No partner key needed.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to look for, e.g. \"webhook signature\", \"send template\", \"coexistence\", \"error 131047\"."
    }
  },
  "required": [
    "query"
  ]
}
🟢bridge_docs_section(heading, doc)

Return the full text of one section (with its sub-sections) of the WasapFlow Bridge docs, e.g. "Verify Incoming Webhooks", "Send Template Message", "Webhook Event Payloads", "Error Codes". No partner key needed.

Input Schema

{
  "type": "object",
  "properties": {
    "heading": {
      "type": "string",
      "description": "Section heading (exact or partial)."
    },
    "doc": {
      "type": "string",
      "enum": [
        "api",
        "guide",
        "changelog"
      ],
      "description": "Optional: which document."
    }
  },
  "required": [
    "heading"
  ]
}
🟢bridge_list_numbers(limit)

List the WhatsApp Business Accounts (client numbers) registered to this partner, with status.

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50
    }
  }
}
🟢bridge_number_status(waba_id)

Live status of a number from Meta: verified name, quality rating, messaging limit, name status.

Input Schema

{
  "type": "object",
  "properties": {
    "waba_id": {
      "type": "string",
      "description": "WhatsApp Business Account ID registered to your partner account (see bridge_list_numbers)."
    }
  },
  "required": [
    "waba_id"
  ]
}
🟡bridge_connect_link(display_name, state)

Create a short-lived (30 min) link that a business opens to connect its WhatsApp number through Meta Embedded Signup (Coexistence supported). Your system should open the returned connect_url for the client, normally behind its own "Connect WhatsApp" button; use this tool to test that flow.

Input Schema

{
  "type": "object",
  "properties": {
    "display_name": {
      "type": "string",
      "description": "Business name shown on the page."
    },
    "state": {
      "type": "string",
      "description": "Your own client id; returned unchanged when the connection completes (popup postMessage, register-from-code response, GET /onboarding/events)."
    }
  }
}
🟡bridge_send_text(waba_id, to, text, idempotency_key, biz_opaque_callback_data)

Send a text message from a connected number. Free-form text only reaches people who messaged that number in the last 24 hours; otherwise use bridge_send_template. This sends a real message.

Input Schema

{
  "type": "object",
  "properties": {
    "waba_id": {
      "type": "string",
      "description": "WhatsApp Business Account ID registered to your partner account (see bridge_list_numbers)."
    },
    "to": {
      "type": "string",
      "description": "Recipient phone in international format without + (e.g. 60123456789) or a BSUID."
    },
    "text": {
      "type": "string",
      "description": "Message text."
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 255,
      "description": "Optional Idempotency-Key (1-255 chars). Reuse the same key when retrying the same message: a repeat with the same key and body within 24 hours returns the original response and does not send again."
    },
    "biz_opaque_callback_data": {
      "type": "string",
      "maxLength": 512,
      "description": "Optional biz_opaque_callback_data: your own reference (order id, ticket id), max 512 chars. Meta returns it on every status webhook of this message as data.biz_opaque_callback_data."
    }
  },
  "required": [
    "waba_id",
    "to",
    "text"
  ]
}
🟡bridge_send_template(waba_id, to, name, language, components, ...)

Send an approved template (works outside the 24-hour window). components follows the Meta Cloud API format. This sends a real message and Meta may charge for it.

Input Schema

{
  "type": "object",
  "properties": {
    "waba_id": {
      "type": "string",
      "description": "WhatsApp Business Account ID registered to your partner account (see bridge_list_numbers)."
    },
    "to": {
      "type": "string",
      "description": "Recipient phone in international format without +."
    },
    "name": {
      "type": "string",
      "description": "Template name."
    },
    "language": {
      "type": "string",
      "description": "Template language code, e.g. en_US, ms."
    },
    "components": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Optional Meta template components (header/body/button parameters)."
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 255,
      "description": "Optional Idempotency-Key (1-255 chars). Reuse the same key when retrying the same message: a repeat with the same key and body within 24 hours returns the original response and does not send again."
    },
    "biz_opaque_callback_data": {
      "type": "string",
      "maxLength": 512,
      "description": "Optional biz_opaque_callback_data: your own reference (order id, ticket id), max 512 chars. Meta returns it on every status webhook of this message as data.biz_opaque_callback_data."
    }
  },
  "required": [
    "waba_id",
    "to",
    "name",
    "language"
  ]
}
🟡bridge_send_marketing(waba_id, to, name, language, components, ...)

Send an approved MARKETING template through Meta's Marketing Messages API (quality-based delivery, marketing metrics). Not onboarded yet? Meta falls back to Cloud API unless product_policy is STRICT. This sends a real message and Meta charges for it.

Input Schema

{
  "type": "object",
  "properties": {
    "waba_id": {
      "type": "string",
      "description": "WhatsApp Business Account ID registered to your partner account (see bridge_list_numbers)."
    },
    "to": {
      "type": "string",
      "description": "Recipient phone in international format without +, or a BSUID."
    },
    "name": {
      "type": "string",
      "description": "Marketing template name."
    },
    "language": {
      "type": "string",
      "description": "Template language code, e.g. en_US, ms."
    },
    "components": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Optional Meta template components."
    },
    "product_policy": {
      "type": "string",
      "enum": [
        "CLOUD_API_FALLBACK",
        "STRICT"
      ],
      "description": "Optional. STRICT = never fall back to Cloud API."
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 255,
      "description": "Optional Idempotency-Key (1-255 chars). Reuse the same key when retrying the same message: a repeat with the same key and body within 24 hours returns the original response and does not send again."
    },
    "biz_opaque_callback_data": {
      "type": "string",
      "maxLength": 512,
      "description": "Optional biz_opaque_callback_data: your own reference (order id, ticket id), max 512 chars. Meta returns it on every status webhook of this message as data.biz_opaque_callback_data."
    }
  },
  "required": [
    "waba_id",
    "to",
    "name",
    "language"
  ]
}
🟢bridge_list_templates(waba_id)

List the message templates of a number with their approval status.

Input Schema

{
  "type": "object",
  "properties": {
    "waba_id": {
      "type": "string",
      "description": "WhatsApp Business Account ID registered to your partner account (see bridge_list_numbers)."
    }
  },
  "required": [
    "waba_id"
  ]
}
🟢bridge_failed_webhooks(limit)

Webhook events Bridge could not deliver to your webhook URL (with the error). Bridge retries each one automatically for 24 hours (1m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, then every 8h); auto_retry shows the next attempt, and final=true means the schedule ended and the event needs bridge_retry_webhooks. Use when incoming messages or statuses are missing in the CRM.

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50
    }
  }
}
⚪bridge_retry_webhooks(event_id)

Redeliver one failed webhook event (event_id) or all of them (omit event_id) after the webhook endpoint is fixed.

Input Schema

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string",
      "description": "Optional event id from bridge_failed_webhooks."
    }
  }
}
🟢bridge_usage

Current Bridge plan: active WhatsApp numbers, slots and the monthly Bridge fee.

Input Schema

{
  "type": "object",
  "properties": {}
}
⚪bridge_open_ticket(subject, message, category, priority, waba_id, ...)

Open a WasapFlow support ticket. Include what happened, when (with timezone), the exact error (Meta code, fbtrace_id), what was tried and the business impact.

Input Schema

{
  "type": "object",
  "properties": {
    "subject": {
      "type": "string",
      "description": "Short summary, max 200 characters."
    },
    "message": {
      "type": "string",
      "description": "Full details."
    },
    "category": {
      "type": "string",
      "enum": [
        "technical",
        "billing",
        "onboarding",
        "other"
      ]
    },
    "priority": {
      "type": "string",
      "enum": [
        "normal",
        "high",
        "urgent"
      ]
    },
    "waba_id": {
      "type": "string",
      "description": "Optional: the affected number's WABA ID."
    },
    "diagnostics": {
      "type": "object",
      "description": "Optional raw error JSON / sample request (max 20 KB)."
    }
  },
  "required": [
    "subject",
    "message"
  ]
}
🟢bridge_list_tickets(status)

List support tickets and replies status.

Input Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "open",
        "replied",
        "closed"
      ]
    }
  }
}
🔴bridge_call_api(method, path, waba_id, query, body, ...)

Call any WasapFlow Bridge endpoint not covered by the other tools (see bridge_docs_search for paths). Irreversible endpoints need {"confirm": true} in the body. Confirm with the user before any call that sends, deletes or changes something.

Input Schema

{
  "type": "object",
  "properties": {
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE"
      ]
    },
    "path": {
      "type": "string",
      "description": "Path after /bridge/v1, e.g. /broadcasts or /templates/order_confirmed."
    },
    "waba_id": {
      "type": "string",
      "description": "Optional x-waba-id for number-scoped endpoints."
    },
    "query": {
      "type": "object",
      "description": "Optional query string parameters."
    },
    "body": {
      "type": "object",
      "description": "Optional JSON body. Send endpoints accept biz_opaque_callback_data (your reference, max 512 chars)."
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 255,
      "description": "Optional Idempotency-Key header for send endpoints (POST /messages/*, POST /broadcasts)."
    }
  },
  "required": [
    "method",
    "path"
  ]
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded16 tools