CosVoice

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>.