360Dialog MCP

Learn how to manage your 360Dialog account using an AI agent

Connect your AI agent to 360Dialog's Model Context Protocol (MCP) server and manage WhatsApp infrastructure with ease.

Introduction

360Dialog MCP is a hosted server that gives AI agents secure and grained access to the 360Dialog Hub public API. It is designed to work with popular AI assistants like Claude, Claude Code, Cursor, Codex, VS Code, and more.

Benefits

• Ease of access — Effortlessly manage assets using natural language

• AI-powered flows — Offload existing manual account management flows to AI agents

• Fine-grained access control — Select which scopes to allow during connection

• Optimized for AI — Tool results are efficiently formatted for best inference performance

• UI/JSON previews — See a visual preview of your templates via MCP Apps, and get an example JSON body for sending a template via 360Dialog Messaging API

Capabilities

• Search documentation — Search the public 360Dialog client and partner documentation for troubleshooting, or for implementation reference

• Manage accounts, users and channels — List accounts, users, and channels; surface any issues with channels that might block messaging

• Inspect and edit channel profiles — Inspect and modify a channel's WhatsApp profile, or submit a new display name

• Manage WhatsApp templates — Create, preview, list, and delete WhatsApp templates; get example JSON body for sending a template via 360Dialog Messaging API

• Configure webhooks — Read and set webhook configuration per channel, then test webhook URL for issues

• Query balance and invoices — See account invoices, channel balance, and balance usage stats

Quickstart

1

Connect to MCP

360Dialog MCP is a streamable HTTP server. Any AI tool that has an MCP client, supports the streamable HTTP protocol, and remote MCP servers can connect to it by adding the server's URL:

https://mcp.360dialog.com/mcp

Claude Code users can run this command to connect to the MCP server:

claude mcp add --transport http 360dialog https://mcp.360dialog.com/mcp

Codex users can run this command to connect to the MCP server:

codex mcp add 360dialog --url https://mcp.360dialog.com/mcp

You may need to restart the AI tool afterwards for the changes to take effect.

2

Start Authentication

After adding the MCP server and restarting your MCP client, you will be either:

1. Taken to the 360Dialog MCP consent page, or

2. Be asked by your AI tool to authenticate with the MCP server.

Steps to start or re-attempt authentication with the MCP server vary.

For Claude Code, use the /mcp command to list your MCP servers. Select 360dialog from the list, and select Authenticate.

For Codex, use the following command to log in:

codex mcp login 360dialog

3

Authorize Scopes

Before the log in screen, you will be asked to review the access request and pick scopes you want to grant.

Inspect the redirect URL and ensure it is a link you trust. If it is an untrusted link (e.g. unknown non-localhost URL), click Decline. Otherwise, select which scopes you would like to grant:

Denying scopes will hide corresponding tools from the AI agent. If write:channels is denied, the AI agent will not be shown the set_display_name tool.

After selecting/deselecting scopes, click Approve.

4

Log In

Log into your account via email and password, or with Google or Facebook:

If you have access to multiple accounts under the same login, you may be prompted to select an organization. Select the organization you would like to manage to continue.

5

Test the MCP

Use this example prompt in Claude, Cursor, or your own agent once the server is connected to ensure the connection works:

List my channels in 360Dialog, and tell me whether the webhook is configured for the first channel.

Typical tool flow will be:

1. get_self — Get identity and account context

2. list_channels — Discover available channels

3. get_webhook — Read live webhook configuration

If the tools do not work, attempt to reconnect to the 360Dialog MCP.

You may now start integrating AI agents into your WhatsApp Business Account management flows.