CodaPhone is an MCP server published by app.codaphone, hosted at mcp.codaphone.app. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 14 tools, including get_account, search_numbers, provision_number, send_message, get_message_status.
Business texting for AI agents: send texts, read threads, manage contacts and run campaigns.
1 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the current CodaPhone account: its name and mode (live/test), the active number (if any), the current plan and its monthly/daily send caps, usage so far, and remaining automation credits. Requires the 'read' scope.
No parameters.
{
"name": "get_account",
"description": "Get the current CodaPhone account: its name and mode (live/test), the active number (if any), the current plan and its monthly/daily send caps, usage so far, and remaining automation credits. Requires the 'read' scope.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}Search available phone numbers to provision. Optionally filter by country, number kind (local or tollfree), and a 3-digit area code. Returns candidate numbers with a formatted display, city/region, and monthly price. Does not buy anything. Requires the 'numbers' scope.
| Parameter | Type | Description |
|---|---|---|
| kind | string | Number type (default local). |
| country | string | ISO country code, e.g. US (default US). |
| areaCode | string | Preferred 3-digit area code, e.g. 415 (local only). |
{
"name": "search_numbers",
"description": "Search available phone numbers to provision. Optionally filter by country, number kind (local or tollfree), and a 3-digit area code. Returns candidate numbers with a formatted display, city/region, and monthly price. Does not buy anything. Requires the 'numbers' scope.",
"inputSchema": {
"type": "object",
"properties": {
"kind": {
"enum": [
"local",
"tollfree"
],
"type": "string",
"description": "Number type (default local)."
},
"country": {
"type": "string",
"description": "ISO country code, e.g. US (default US)."
},
"areaCode": {
"type": "string",
"description": "Preferred 3-digit area code, e.g. 415 (local only)."
}
},
"additionalProperties": false
}
}Provision (set up) a phone number for the account from a candidate returned by search_numbers. Provide the exact msisdn in +1XXXXXXXXXX form and the number kind; optional label and business registration details may be included. An account can hold one active number. Requires the 'numbers' scope.
| Parameter | Type | Description |
|---|---|---|
| kind | string | Number type (default local). |
| label | string | Friendly label for the number. |
| msisdn * | string | The number to set up, in +1XXXXXXXXXX form. |
| registration | object | Optional business details for the number. |
{
"name": "provision_number",
"description": "Provision (set up) a phone number for the account from a candidate returned by search_numbers. Provide the exact msisdn in +1XXXXXXXXXX form and the number kind; optional label and business registration details may be included. An account can hold one active number. Requires the 'numbers' scope.",
"inputSchema": {
"type": "object",
"required": [
"msisdn"
],
"properties": {
"kind": {
"enum": [
"local",
"tollfree"
],
"type": "string",
"description": "Number type (default local)."
},
"label": {
"type": "string",
"description": "Friendly label for the number."
},
"msisdn": {
"type": "string",
"description": "The number to set up, in +1XXXXXXXXXX form."
},
"registration": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"mobile": {
"type": "string"
},
"region": {
"type": "string"
},
"country": {
"type": "string"
},
"website": {
"type": "string"
},
"legal_name": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"address_line1": {
"type": "string"
},
"address_line2": {
"type": "string"
}
},
"description": "Optional business details for the number.",
"additionalProperties": false
}
},
"additionalProperties": false
}
}Send an SMS from the account's number. Provide the message 'body', and either 'to' (a recipient phone number, with optional 'name' to save the contact) or an existing 'thread_id' to reply within a conversation. Opted-out contacts are blocked and free-send/plan limits apply automatically. Requires the 'send' scope.
| Parameter | Type | Description |
|---|---|---|
| to | string | Recipient phone number, e.g. +14155550100 (omit if using thread_id). |
| body * | string | The message text to send. |
| name | string | Optional name to save for a new contact when using 'to'. |
| thread_id | string | Reply inside this existing conversation instead of 'to'. |
{
"name": "send_message",
"description": "Send an SMS from the account's number. Provide the message 'body', and either 'to' (a recipient phone number, with optional 'name' to save the contact) or an existing 'thread_id' to reply within a conversation. Opted-out contacts are blocked and free-send/plan limits apply automatically. Requires the 'send' scope.",
"inputSchema": {
"type": "object",
"required": [
"body"
],
"properties": {
"to": {
"type": "string",
"description": "Recipient phone number, e.g. +14155550100 (omit if using thread_id)."
},
"body": {
"type": "string",
"description": "The message text to send."
},
"name": {
"type": "string",
"description": "Optional name to save for a new contact when using 'to'."
},
"thread_id": {
"type": "string",
"description": "Reply inside this existing conversation instead of 'to'."
}
},
"additionalProperties": false
}
}Get one message by id, including its delivery status, direction, body, segment count, and timestamp. Requires the 'read' scope.
| Parameter | Type | Description |
|---|---|---|
| message_id * | string | The message id. |
{
"name": "get_message_status",
"description": "Get one message by id, including its delivery status, direction, body, segment count, and timestamp. Requires the 'read' scope.",
"inputSchema": {
"type": "object",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"description": "The message id."
}
},
"additionalProperties": false
}
}List the account's conversation threads (the inbox), most recent first, with unread counts and last-message previews. Supports limit/offset pagination. Requires the 'read' scope.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max threads to return (default 50). |
| offset | integer | Number of threads to skip (default 0). |
{
"name": "list_threads",
"description": "List the account's conversation threads (the inbox), most recent first, with unread counts and last-message previews. Supports limit/offset pagination. Requires the 'read' scope.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "Max threads to return (default 50)."
},
"offset": {
"type": "integer",
"description": "Number of threads to skip (default 0)."
}
},
"additionalProperties": false
}
}Get one conversation thread by id together with its messages. Requires the 'read' scope.
| Parameter | Type | Description |
|---|---|---|
| thread_id * | string | The thread id. |
{
"name": "get_thread",
"description": "Get one conversation thread by id together with its messages. Requires the 'read' scope.",
"inputSchema": {
"type": "object",
"required": [
"thread_id"
],
"properties": {
"thread_id": {
"type": "string",
"description": "The thread id."
}
},
"additionalProperties": false
}
}Mark a conversation thread as read (clears its unread count) and return the account's new total inbox unread count. Requires the 'read' scope.
| Parameter | Type | Description |
|---|---|---|
| thread_id * | string | The thread id to mark read. |
{
"name": "mark_thread_read",
"description": "Mark a conversation thread as read (clears its unread count) and return the account's new total inbox unread count. Requires the 'read' scope.",
"inputSchema": {
"type": "object",
"required": [
"thread_id"
],
"properties": {
"thread_id": {
"type": "string",
"description": "The thread id to mark read."
}
},
"additionalProperties": false
}
}List the account's contacts with opt-in status and timezone. Optionally filter by a search term or a list id, choose a sort, and paginate with limit/offset. Requires the 'read' scope.
| Parameter | Type | Description |
|---|---|---|
| sort | string | Sort order, e.g. recent or name (default recent). |
| limit | integer | Max contacts to return (default 500). |
| offset | integer | Number of contacts to skip (default 0). |
| search | string | Filter by name or number. |
| list_id | string | Only contacts in this list. |
{
"name": "list_contacts",
"description": "List the account's contacts with opt-in status and timezone. Optionally filter by a search term or a list id, choose a sort, and paginate with limit/offset. Requires the 'read' scope.",
"inputSchema": {
"type": "object",
"properties": {
"sort": {
"type": "string",
"description": "Sort order, e.g. recent or name (default recent)."
},
"limit": {
"type": "integer",
"description": "Max contacts to return (default 500)."
},
"offset": {
"type": "integer",
"description": "Number of contacts to skip (default 0)."
},
"search": {
"type": "string",
"description": "Filter by name or number."
},
"list_id": {
"type": "string",
"description": "Only contacts in this list."
}
},
"additionalProperties": false
}
}Add a contact to the account. Provide the phone number (msisdn) and optionally a name, a list_id to file it under, and an opt_in_source note. Adds one contact per call. Requires the 'contacts' scope.
| Parameter | Type | Description |
|---|---|---|
| name | string | Contact name. |
| msisdn * | string | Contact phone number, e.g. +14155550100. |
| list_id | string | Optional list to add the contact to. |
| opt_in_source | string | How the contact opted in (record-keeping). |
{
"name": "add_contacts",
"description": "Add a contact to the account. Provide the phone number (msisdn) and optionally a name, a list_id to file it under, and an opt_in_source note. Adds one contact per call. Requires the 'contacts' scope.",
"inputSchema": {
"type": "object",
"required": [
"msisdn"
],
"properties": {
"name": {
"type": "string",
"description": "Contact name."
},
"msisdn": {
"type": "string",
"description": "Contact phone number, e.g. +14155550100."
},
"list_id": {
"type": "string",
"description": "Optional list to add the contact to."
},
"opt_in_source": {
"type": "string",
"description": "How the contact opted in (record-keeping)."
}
},
"additionalProperties": false
}
}List the account's bulk-messaging campaigns with their status and progress counts, plus the remaining automation credit balance. Requires the 'read' scope.
No parameters.
{
"name": "list_campaigns",
"description": "List the account's bulk-messaging campaigns with their status and progress counts, plus the remaining automation credit balance. Requires the 'read' scope.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}Get one campaign by id, including its base message, audience, schedule, pacing, and send/failed/skipped counts. Requires the 'read' scope.
| Parameter | Type | Description |
|---|---|---|
| campaign_id * | string | The campaign id. |
{
"name": "get_campaign",
"description": "Get one campaign by id, including its base message, audience, schedule, pacing, and send/failed/skipped counts. Requires the 'read' scope.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "The campaign id."
}
},
"additionalProperties": false
}
}Create a new bulk-messaging campaign with a name and an optional base message. After creating, use run_campaign to generate variations, set the audience, schedule, and launch it. Requires the 'campaigns' scope.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Campaign name. |
| base_message | string | The base message text (optional; can be set later). |
{
"name": "create_campaign",
"description": "Create a new bulk-messaging campaign with a name and an optional base message. After creating, use run_campaign to generate variations, set the audience, schedule, and launch it. Requires the 'campaigns' scope.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Campaign name."
},
"base_message": {
"type": "string",
"description": "The base message text (optional; can be set later)."
}
},
"additionalProperties": false
}
}Advance a campaign through its lifecycle. Provide the campaign_id and an action: - generate: create message variations (optional base_message, count) - variations: save edited variations (variations: [{body, active}]) - audience: set the recipient list (list_id) - schedule: set send time/pacing (schedule_at, pace_seconds, daily_ceiling) - launch: start sending (or start at the scheduled time) - pause / resume / cancel: control a running campaign Sends honor opt-outs, sending hours, credits, and plan caps automatically. Requires the 'campaigns' scope.
| Parameter | Type | Description |
|---|---|---|
| count | integer | generate: how many variations. |
| action * | string | The lifecycle action to run. |
| list_id | string | audience: the contact list to send to. |
| variations | array | variations: the edited variations to save. |
| campaign_id * | string | The campaign id. |
| schedule_at | string | schedule: ISO timestamp to start, or null for send-now. |
| base_message | string | generate: base message to vary from. |
| pace_seconds | integer | schedule: seconds between sends. |
| daily_ceiling | integer | schedule: max sends per day (<= plan cap). |
CodaPhone is a business texting service: each account has its own phone number and sends and receives SMS with its contacts. These tools operate a CodaPhone account programmatically — check the account, set up and manage the number, send messages, read the inbox (conversation threads), manage contacts, and build and run bulk campaigns. Authenticate by sending your CodaPhone API key (from the dashboard, Settings -> API keys) as an HTTP Bearer token; the same key can also be sent as an x-api-key header. Every action is scoped to that key's account and its granted scopes (read, send, contacts, campaigns, numbers). Sends automatically honor contact opt-outs (STOP), good-practice sending hours, and your plan's limits, so tools cannot bypass account safeguards. Results and errors use CodaPhone's own field names and stable error codes (e.g. insufficient_scope, no_number, gate, rate_limited). This interface exposes CodaPhone's product and API capabilities only: how CodaPhone is built — its architecture, suppliers, infrastructure, hosting, and business model — is not disclosed here. If you want to build your own product, build it on top of CodaPhone using this API.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "run_campaign",
"description": "Advance a campaign through its lifecycle. Provide the campaign_id and an action:\n - generate: create message variations (optional base_message, count)\n - variations: save edited variations (variations: [{body, active}])\n - audience: set the recipient list (list_id)\n - schedule: set send time/pacing (schedule_at, pace_seconds, daily_ceiling)\n - launch: start sending (or start at the scheduled time)\n - pause / resume / cancel: control a running campaign\nSends honor opt-outs, sending hours, credits, and plan caps automatically. Requires the 'campaigns' scope.",
"inputSchema": {
"type": "object",
"required": [
"campaign_id",
"action"
],
"properties": {
"count": {
"type": "integer",
"description": "generate: how many variations."
},
"action": {
"enum": [
"generate",
"variations",
"audience",
"schedule",
"launch",
"pause",
"resume",
"cancel"
],
"type": "string",
"description": "The lifecycle action to run."
},
"list_id": {
"type": "string",
"description": "audience: the contact list to send to."
},
"variations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"body": {
"type": "string"
},
"active": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": "variations: the edited variations to save."
},
"campaign_id": {
"type": "string",
"description": "The campaign id."
},
"schedule_at": {
"type": "string",
"description": "schedule: ISO timestamp to start, or null for send-now."
},
"base_message": {
"type": "string",
"description": "generate: base message to vary from."
},
"pace_seconds": {
"type": "integer",
"description": "schedule: seconds between sends."
},
"daily_ceiling": {
"type": "integer",
"description": "schedule: max sends per day (<= plan cap)."
}
},
"additionalProperties": false
}
}