Tools
All endpoints available in the 2Chat REST API are also exposed as MCP tools — your AI assistant can call any of them directly.
Messaging
send_whatsapp_message
Send a WhatsApp text message from one of your connected channels.
| Input | Type | Required | Description |
|---|---|---|---|
from | string | yes | Your channel's phone number (E.164, e.g. +15550001111) |
to | string | yes | Recipient's phone number (E.164) |
text | string | yes | Message body |
Returns: message_id, status, timestamp.
"Send a WhatsApp from +15551111111 to +15550009999 saying: Your order is ready for pickup."
check_whatsapp_number
Check whether a phone number has an active WhatsApp account before sending.
| Input | Type | Required | Description |
|---|---|---|---|
channel_number | string | yes | Your channel's phone number |
phone_number | string | yes | Number to check |
Returns: exists (boolean), number.
"Check if +15550009999 is on WhatsApp using my channel +15551111111. If yes, send them: 'Hi from 2Chat!'"
Contacts
create_contact
Create a new contact in your 2Chat account.
| Input | Type | Required | Description |
|---|---|---|---|
phone | string | yes | Contact phone number (E.164) |
name | string | no | Display name |
email | string | no | Email address |
Returns: contact object with uuid, phone, name.
"Create a 2Chat contact named Acme Corp with phone +15550009999 and email ops@acme.com."
get_contact
Retrieve a contact by their UUID.
| Input | Type | Required | Description |
|---|---|---|---|
contact_uuid | string | yes | UUID of the contact |
Returns: full contact object.
search_contacts
Search for contacts by phone number or name.
| Input | Type | Required | Description |
|---|---|---|---|
query | string | yes | Partial phone number or name |
Returns: array of matching contacts.
"Find the 2Chat contact named Acme Corp and update their email to operations@acme.com."
update_contact
Update an existing contact's details.
| Input | Type | Required | Description |
|---|---|---|---|
contact_uuid | string | yes | UUID of the contact to update |
name | string | no | New display name |
email | string | no | New email address |
Returns: updated contact object.
delete_contact
Delete a contact from your account.
| Input | Type | Required | Description |
|---|---|---|---|
contact_uuid | string | yes | UUID of the contact to delete |
Returns: confirmation of deletion.
Channels
list_channels
List all WhatsApp channels connected to your account, with their status.
Returns: array of channels with phone_number, status (connected / disconnected), type.
"List my 2Chat WhatsApp channels and tell me which ones are currently connected."
get_channel_status
Get the current connection status for a specific channel.
| Input | Type | Required | Description |
|---|---|---|---|
channel_number | string | yes | Phone number of the channel |
Returns: status, last_seen, phone_number.
Phone Numbers
search_phone_number_groups
Search for available virtual phone numbers to purchase.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166-1 alpha-2 country code (e.g. US) |
did_type | string | no | local, mobile, tollfree, national |
region_id | string | no | Region ID from list_regions |
Returns: array of number groups with pricing and features.
"Search for available local phone numbers in California, USA. Show me the first 3 options with pricing."
list_virtual_numbers
List virtual phone numbers assigned to your account.
Returns: array of virtual numbers with number, country, features.