> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contactship.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP — Manage agents from any AI

> Connect ContactShip with Claude, Cursor, and other AI assistants to manage voice agents with natural language.

## What is ContactShip MCP?

Imagine managing all your voice agents just by talking to your favorite AI assistant.

Instead of logging into the platform, finding the agent, editing the prompt, configuring the voice, saving, testing, and repeating... you simply say:

> "Create a collections agent for Mexico that sounds professional. Extract whether the customer committed to pay and the amount."

Done. 30 seconds.

That's **ContactShip MCP**: a bridge that connects your ContactShip account with AI assistants like Claude, Cursor, or Claude Code. You talk in plain language, and the AI handles all the technical stuff.

***

## What can you do?

<CardGroup cols={2}>
  <Card title="Manage agents" icon="robot">
    View, create, and edit your voice agents. Change prompts, voice, language, speed — all from the chat.
  </Card>

  <Card title="Launch calls" icon="phone">
    Start an AI phone call instantly, or schedule one for later.
  </Card>

  <Card title="Search contacts" icon="address-book">
    Find contacts by name, email, or phone. View complete call history.
  </Card>

  <Card title="See your numbers" icon="hashtag">
    View your available phone numbers for outbound calls.
  </Card>

  <Card title="Review call results" icon="chart-bar">
    Ask your AI to review all your voice agent call results at scale — find patterns, check quality, get summaries — without listening to recordings one by one.
  </Card>
</CardGroup>

***

## How does it work?

<Steps>
  <Step title="Pick your AI tool">
    Works with Claude (web, desktop, and Code), Cursor, and any MCP-compatible app.
  </Step>

  <Step title="Connect your account">
    Paste your ContactShip API key and you're done. Takes less than 2 minutes.
  </Step>

  <Step title="Talk to your AI">
    Ask for what you need in plain language. The AI understands the context and takes action for you.
  </Step>
</Steps>

***

## Real examples

**Edit an agent:**

> "Make my sales agent sound warmer and change the language to Mexican Spanish."

**Launch a call:**

> "Call Juan Pérez at +52 55 1234 5678 with the survey agent."

**Search for a contact:**

> "Find the contact with email [maria@company.com](mailto:maria@company.com) and show their call history."

**Configure post-call analysis:**

> "Add a field to the collections agent to track whether the customer committed to pay, the amount, and the date."

**Review call results:**

> "Show me all calls from today and summarize the results."

> "Get the transcript of the last call with Juan Pérez."

> "Which calls this week had a positive outcome? Give me a summary."

> "Find calls where the customer mentioned a payment issue."

***

## Reviewing call results at scale

With the `list_calls` and `get_call` MCP tools, your AI assistant can access all your voice agent call results directly — no need to manually open recordings or read transcripts one by one.

Ask your AI to:

* **List and filter calls** — by date, agent, contact, or outcome
* **Get full call details** — transcript, extracted variables, duration, recording
* **Find patterns** — which calls succeeded, which had objections, what customers said most

Call transcripts use **TOON format** (Turn-Oriented Optimized Notation), a compact representation designed for efficient AI processing. This means your AI can read and reason over large numbers of call transcripts quickly and accurately.

***

## Requirements

<Check>A ContactShip account with a Starter subscription (\$30 USD/month) or above</Check>
<Check>Your API key — generate it from [Settings > API Keys](https://app.contactship.ai/es/organization/api-keys)</Check>
<Check>A compatible AI assistant (Claude, Cursor, or any MCP-enabled client)</Check>

***

## Connect your tool

<CardGroup cols={2}>
  <Card title="Claude (web)" icon="globe" href="/en/mcp/claude">
    Connect from claude.ai to manage agents right from your browser.
  </Card>

  <Card title="Claude Code" icon="terminal" href="/en/mcp/claude-code">
    Connect from the terminal for development and automation workflows.
  </Card>

  <Card title="Cursor" icon="code" href="/en/mcp/cursor">
    Connect from Cursor IDE to manage agents without leaving your editor.
  </Card>
</CardGroup>

<Tip>
  Don't have your API key? Generate it at [app.contactship.ai/es/organization/api-keys](https://app.contactship.ai/es/organization/api-keys). Requires a Starter subscription or above.
</Tip>