> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.360dialog.com/docs/get-started/mcp.md).
# 360Dialog MCP
Connect your AI agent to 360Dialog's [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) 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](https://modelcontextprotocol.io/extensions/apps/overview), 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
{% stepper %}
{% step %}
### 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:
```shellscript
https://mcp.360dialog.com/mcp
```
**Claude Code** users can run this command to connect to the MCP server:
```shellscript
claude mcp add --transport http 360dialog https://mcp.360dialog.com/mcp
```
**Codex** users can run this command to connect to the MCP server:
{% code overflow="wrap" %}
```shellscript
codex mcp add 360dialog --url https://mcp.360dialog.com/mcp
```
{% endcode %}
You may need to restart the AI tool afterwards for the changes to take effect.
{% endstep %}
{% step %}
### 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:
{% code overflow="wrap" %}
```shellscript
codex mcp login 360dialog
```
{% endcode %}
{% endstep %}
{% step %}
### 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.**
{% endstep %}
{% step %}
### 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.
{% endstep %}
{% step %}
### Test the MCP
Use this example prompt in Claude, Cursor, or your own agent once the server is connected to ensure the connection works:
{% code overflow="wrap" %}
```
List my channels in 360Dialog, and tell me whether the webhook is configured for the first channel.
```
{% endcode %}
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.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.360dialog.com/docs/get-started/mcp.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.