Claude Code + OmniChannels.ai: build and test messaging from your terminal

What you can do

• Write code from the real templates

  Claude Code reads your approved WhatsApp templates through MCP and writes a function with exactly the variables each one needs.

  Try asking

  “Use the omnichannels tools to list my approved WhatsApp templates, then write a TypeScript function that sends order_update with the fields it needs.”

• Build a webhook handler

  Point Claude Code at the webhooks guide and it writes an endpoint that stores delivery statuses and inbound messages, tolerating fields that vary by channel.

  Try asking

  “Write an Express webhook handler that records SUBMITTED, SENT, DELIVERED, READ, FAILED and REJECTED statuses by message ID and logs unknown fields instead of failing.”

• Generate a typed client from the spec

  With the OpenAPI spec saved in your repository, Claude Code uses the exact paths and fields instead of guessing them.

  Try asking

  “Using docs/omnichannels-openapi.yaml, write a Python module that sends an SMS with POST /sms/sendSms and list every field you used with its type from the spec.”

• Test end to end on your own number

  Claude Code sends a test message after you approve the tool call, then checks the delivery report to confirm your code path works.

  Try asking

  “Send a test SMS from OmniDemo to my number 447700900123, then check its delivery report.”

• Debug failed sends

  Read tools let Claude Code compare delivery reports with your logs and trace a failure back to the request that caused it.

  Try asking

  “Read the delivery report for yesterday's campaign, summarise the failure reasons, and check our retry code against the errors guide.”

How it connects

Set it up

1. 1

   Request API access

   Request test access and receive an API token. Test sends go only to your own verified numbers.

2. 2

   Get a temporary key

   In the admin portal open Integrations, then MCP Integration, choose Get temporary key and export it as BROADNET_TOKEN.

   Guide: MCP server for AI agents
3. 3

   Add the server

   Run claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp with the Authorization header, or commit a project .mcp.json for your team, then check it with /mcp.

   Guide: Use the MCP server with Claude Code
4. 4

   Set permission rules

   Allow read tools such as mcp__omnichannels__get_* if you want, keep every send tool on prompt, and deny tools the project does not need.

   Guide: Use the MCP server with Claude Code
5. 5

   Add the OpenAPI spec

   Download openapi.yaml into your repository and tell Claude Code to use it for endpoint paths, fields and enums.

   Guide: OpenAPI 3.1 spec
6. 6

   Test on your own number

   Ask Claude Code to send a test message to your verified number, then read back the delivery report.