# CosVoice [Health: Active]

**Category:** 🗣️ Conversational AI  
**Repository:** https://cosvoice.com/mcp  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/cosvoice

## Description
CosVoice gives your AI Chief of Staff (Grok Bot, Claude, ChatGPT, Cursor) a real US phone number and email. It calls, answers, and sends written summaries. Connect via https://cosvoice.com/mcp — from $29/mo.

## Tools
Capabilities this server exposes over MCP:

- **get_account** — Who this key belongs to and whether a line exists yet.
- **search_numbers** — Find available phone numbers in a US area code for a new line.
- **create_line** — Set up the phone line: claim a number (pick one from search_numbers or just give an area code), name the persona, and register the owner's mobile. An account can own several lines; each needs its own paid plan (if none is waiting, this returns a checkout link). Ask the owner before opting them in to texts.
- **get_line** — Number, email identity, persona, owner, and minutes remaining this period.
- **place_call** — Have the line call a real number and hold a live voice conversation on the owner's behalf. Brief it like a human assistant: who to ask for, what you want, acceptable fallbacks, what to do on voicemail. Set connect_owner when the owner wants to be put through once a human is reached (the line waits on hold, then rings the owner). Asynchronous: poll get_call or wait for the call.completed webhook.
- **book_reservation** — Reserve a table by phone: the line calls the venue, negotiates the time, answers the host's questions (name, callback, email), records policies, and never pays. Give the venue's phone number, party size, date/time, and the acceptable window or fallbacks. Returns reservation_id and call_id; read the outcome with get_call or list_reservations before telling the owner anything is confirmed. Statuses: confirmed, alternative_confirmed, waitlisted, hold, requires_online, needs_owner, callback_later, no_availability, declined_by_venue, voicemail, not_reached.
- **list_reservations** — Recent reservation requests with their status and the venue's stated policies.
- **get_call** — Status, structured notes, outcome, transcript, and annotations for one call.
- **list_calls** — Recent calls with summaries, newest first.
- **annotate_call** — Attach a note to a call (what you did about it, a decision, context for the owner). Shows in the dashboard next to the debrief.
- **send_text** — Send an SMS from the line's number. Respects STOP opt-outs. Read the delivery field in the result: while CosVoice's carrier registration (10DLC) is in progress, texts from the line may be filtered by US carriers and not arrive; texts to the line and calls always work.
- **ack_instructions** — Mark owner instructions (texts the owner sent to the line) as handled so they stop being attached to tool results. Pass the ids from the OWNER INSTRUCTIONS notice, or all: true.
- **list_messages** — Recent texts to and from the line.
- **list_emails** — Email received at and sent from the line's address, newest first (direction inbound|outbound), with forwarding status.
- **get_email** — Full text of one email the line received.
- **send_email** — Send an email from the line's own address (handle@cosvoice.com). Reply to a message the line received by passing reply_to_email_id (recipient and subject fill in, threading is kept), or write to the owner. The line may only email people who have emailed it first, its owner, or its Bot inbox. Plain text; keep it short and sign as the line.
- **forward_email** — Forward one received email to one of the line's own inboxes: its forwarding, notification or Bot inbox, or the owner's sign-in address (defaults to the forwarding inbox). It cannot forward to any other address, and a new inbox must be confirmed by its owner first.
- **list_contacts** — Owner, approved, VIP, and blocked numbers.
- **add_contact** — Teach the line a number. Roles: approved (reaches the owner), vip (interrupts), blocked (polite wall).
- **remove_contact** — Remove a number from the contacts list (not the owner).
- **get_settings** — Persona, voice, greeting, standing instructions, owner, notifications, forwarding, webhook, Bot push, SMS consent.
- **update_settings** — Change any of: name, voice, greeting, instructions, owner_name, owner_phone, timezone, notify_email, agent_email, morning_brief (daily digest on/off), morning_brief_hour (0–23 local), forward_email, forward_mode (relay|raw|off), sms_opt_in, answer_rings (0|1|2). Only the fields you pass change.
- **set_bot_push** — Have CosVoice start YOU the moment something arrives, instead of you polling. Give it the webhook URL and key of a routine of yours that has a Webhook trigger (Grok Bot: Routines → New → trigger Webhook; the URL and a crsr_ key appear). CosVoice POSTs a JSON body with what_to_do plus the ids when the owner texts an instruction, an email arrives, or a call finishes; that body becomes the routine's input. Pass an empty url to turn it off. events limits which moments wake you (default instruction, email, call); add "message" to also be started when anyone other than the owner texts the line. When you pass a key, CosVoice sends a test push at once and returns the result in test: read it, a saved key is not a working key until the routine has accepted one.
- **set_webhook** — Set (or clear with an empty url) the HTTPS webhook that receives call.completed, message.received, and email.received. Returns the signing secret once.
- **list_history** — Unified history of calls, texts, and email with optional search. The same table as the dashboard.
- **recent_activity** — Everything since a timestamp: calls, texts, emails. Catch-up when webhooks were missed.
- **list_integrations** — Partner integrations available through this line (groceries, food, reservations, travel…), with status and connect links. Partner tools appear as <partner>__<tool>.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "cosvoice": {
    "url": "https://cosvoice.com/mcp"
  }
}
```

## Documentation

## What CosVoice MCP server does

CosVoice gives an MCP-compatible agent access to a US phone line and an email identity in the form of `handle@cosvoice.com`. Each line has a persona, owner details, instructions, notifications, forwarding settings, and a monthly minutes allowance. Accounts can own multiple lines, with a separate paid plan for each line. If a line does not have a plan waiting, line creation returns a checkout link.

The phone tools cover outbound calls, SMS, contact management, reservation requests, and call history. The email tools cover messages received by the line, replies, owner-directed email, and forwarding to approved inboxes. Agents can also inspect unified activity across calls, texts, and email.

## How it works

Connect an MCP client to `https://cosvoice.com/mcp`. An agent can check the account, search for available numbers by US area code, and create a line using a selected number or an area code. Creating a line also sets the persona and registers the owner's mobile; the owner should be asked before enabling text opt-in.

Calls and reservation requests are asynchronous. `place_call` returns identifiers for the call, while `get_call` provides status, notes, outcome, transcript, and annotations. Reservation requests return a reservation ID and call ID; use `get_call` or `list_reservations` before reporting that a booking is confirmed. Reservation outcomes include confirmed, alternative confirmed, waitlisted, requires online action, needs owner input, and unavailable states.

Agents can either poll for results or configure HTTPS webhooks for completed calls, received messages, and received email. `recent_activity` supports catch-up after missed webhooks. A separate bot-push setting can start a configured routine when owner instructions, email, or calls arrive, and can optionally include messages from other senders.

## Setup and configuration

Start with an account key and connect the remote MCP URL in the chosen client. Use `get_account` to identify the account and check whether a line exists. After creating a line, `get_settings` and `update_settings` manage the persona, voice, greeting, standing instructions, owner information, timezone, notification email, morning digest, forwarding mode, SMS consent, and answer behavior.

Webhook delivery uses an HTTPS URL and returns a signing secret when configured. Bot push uses a webhook URL and key for a routine with a Webhook trigger; passing an empty URL disables it. When a bot-push key is supplied, CosVoice sends a test push immediately, and the result should be checked for acceptance.

## Tools and capabilities

- Find and claim US phone numbers, then create and inspect lines.
- Place live calls with instructions, fallback behavior, voicemail guidance, and optional owner connection.
- Request restaurant reservations and track venue responses and policies.
- Send SMS and inspect incoming and outgoing messages.
- Read, send, reply to, and forward line email within recipient restrictions.
- Add approved, VIP, and blocked contacts.
- Review calls, reservations, messages, email, and unified history.
- Add annotations to calls and acknowledge handled owner instructions.
- Discover partner integrations available to a line.

## Limitations and notes

CosVoice only sends email to people who have already emailed the line, the owner, or the Bot inbox. Forwarding is limited to the line's configured forwarding, notification, or Bot inboxes, or the owner's sign-in address; a new inbox must first be confirmed by its owner.

SMS respects STOP opt-outs. While carrier registration is in progress, US carriers may filter texts sent from the line, although texts sent to the line and calls continue to work. The reservation tool never pays a venue, and an agent should not treat a request as confirmed until the returned status supports that conclusion. Partner tools are exposed under names based on the partner and tool, such as `<partner>__<tool>`.

_Full upstream README: https://allmcps.com/mcp/cosvoice/readme_