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

# MCP Server

> Connect Claude, ChatGPT, Cursor, or another MCP app to your Answering Agent account. Ask about your calls, tasks, customers, and reports, and update tasks.

The Answering Agent MCP server lets an AI app read your Answering Agent data. Ask "What was our AI-resolved rate by location last week?" or "Find the call where someone mentioned a damaged mirror," and the app looks up the answer in your account. The app can also change a task's status or assignee and add internal notes to tasks. Any app that supports remote MCP (Model Context Protocol) servers can connect, including Claude, ChatGPT, Cursor, and VS Code.

```
https://answeringagent.com/api/mcp
```

The server runs on Answering Agent, so there is nothing to install. You sign in with your dashboard login over OAuth, and the server sees what you see in the dashboard.

## Who can connect

* Team owners, admins, and managers can connect. Other roles see "AI app connections aren't available for this account."
* Each connection works on one team, the team you have open in the dashboard when you connect.

## Connect your AI app

<Tabs>
  <Tab title="Claude">
    These steps work in Claude on the web and in Claude Desktop. A connector you add in one shows up in the other.

    1. Go to **Customize → Connectors**.
    2. Click **+ Add**, then **Add custom connector**.
    3. Enter `Answering Agent` as the name and `https://answeringagent.com/api/mcp` as the URL.
    4. Click **Continue** and follow the prompts to sign in.

    On Team and Enterprise plans, an owner adds the connector first under **Organization settings → Connectors**. Members then find it under **Customize → Connectors** and click **Connect**. Free plans allow one custom connector. See Anthropic's guide to [custom connectors](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp).
  </Tab>

  <Tab title="Claude Code">
    Add the server:

    ```bash theme={null}
    claude mcp add --transport http answering-agent https://answeringagent.com/api/mcp
    ```

    Then run `/mcp` in Claude Code, choose `answering-agent`, and sign in in the browser window that opens. To share the server with your repository, add `--scope project`, which writes it to `.mcp.json`. See [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp).
  </Tab>

  <Tab title="ChatGPT">
    1. Open [chatgpt.com/plugins](https://chatgpt.com/plugins).
    2. Click **+**, then **Add custom MCP server**.
    3. Enter `Answering Agent` as the name and `https://answeringagent.com/api/mcp` as the server URL.
    4. Review the warning, then create the plugin and sign in.

    Your ChatGPT plan and workspace settings decide whether you can add a custom MCP server. If you don't see the option, ask your workspace admin. See OpenAI's guide to [connecting an MCP server to ChatGPT](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt).
  </Tab>

  <Tab title="Cursor">
    [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=answering-agent\&config=eyJ1cmwiOiJodHRwczovL2Fuc3dlcmluZ2FnZW50LmNvbS9hcGkvbWNwIn0=) with one click, or add the server to `~/.cursor/mcp.json` for every project or `.cursor/mcp.json` for one:

    ```json theme={null}
    {
      "mcpServers": {
        "answering-agent": {
          "url": "https://answeringagent.com/api/mcp"
        }
      }
    }
    ```

    Sign in when Cursor asks. See Cursor's [MCP docs](https://cursor.com/docs/context/mcp).
  </Tab>

  <Tab title="VS Code">
    [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22answering-agent%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fansweringagent.com%2Fapi%2Fmcp%22%7D) with one click, or add the server to `.vscode/mcp.json` in your workspace:

    ```json theme={null}
    {
      "servers": {
        "answering-agent": {
          "type": "http",
          "url": "https://answeringagent.com/api/mcp"
        }
      }
    }
    ```

    VS Code asks you to trust the server, then opens a browser window to sign in. Use the server from Copilot Chat in agent mode. See [Add and manage MCP servers in VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).
  </Tab>

  <Tab title="Other apps">
    Any app that supports remote MCP servers over HTTP with OAuth sign-in can connect. Add a remote server with the URL `https://answeringagent.com/api/mcp`. Apps that use a JSON config usually take an entry like this one:

    ```json theme={null}
    {
      "mcpServers": {
        "answering-agent": {
          "url": "https://answeringagent.com/api/mcp"
        }
      }
    }
    ```

    Windsurf, now Devin Desktop, also accepts `serverUrl` in place of `url`. See [Devin Desktop MCP docs](https://docs.devin.ai/desktop/cascade/mcp).
  </Tab>
</Tabs>

## Sign in and approve

The first time the app uses the server, it opens a sign-in window.

1. Sign in with the login you use for the Answering Agent dashboard.
2. Answering Agent shows **Connect an AI app to** your team name and lists what the app can do. Check the team, then click **Approve**.
3. On the next screen, allow the AI app to access your account.
4. Back in the AI app, the server shows as connected. Ask it a question.

If you see **This connection request expired**, start again from the AI app.

## Try these prompts

* "What was our AI-resolved rate each week for the last 8 weeks, by location?"
* "Who closed the most tasks in the last 30 days, and what was their median time to close?"
* "What did customers ask for most this week? Group it by category."
* "Find the call where a customer mentioned a damaged mirror and summarize what they said."
* "How many retention offers did we pitch last month, and how many were accepted?"
* "Which hours of the day get the most calls at the Lamar Blvd location?"
* "List the open tasks assigned to me, oldest first."
* "What greeting does the Lamar Blvd line use?"
* "Assign the oldest open damage claim to Priya and add a note that the customer sent photos."
* "Mark Dana Ruiz's cancellation task done and add a note that her membership is cancelled in the POS."

## Tools

Most tools only look things up:

| Tool | What it does |
| - | - |
| `get_account` | Your team's phone lines, members and roles, connected point-of-sale systems, features, open task count, and today's date. |
| `search_conversations` | Searches calls, texts, website chats, and emails by customer or by words in the title, summary, or category. |
| `get_conversation` | One conversation with its summary, the customer's questions, its follow-up task, and the full transcript. |
| `search_tasks` | Searches tasks by title, description, or customer, with status and date filters. |
| `get_task` | One task with its full description, source conversation or form, and assignee. |
| `search_contacts` | Searches customers by name, phone, email, company, or notes. |
| `get_contact` | One customer with their details and 10 most recent conversations. |
| `run_report` | Runs a report from the [metric catalog](/api/reports#metric-catalog), such as AI-resolved rate, task closes by teammate, or retention offers. |
| `get_settings` | The AI's settings for the team or one phone line: greeting, voice, prompt, offers, text links, and forwarding rules. |
| `list_support_requests` | Support requests sent to the Answering Agent team, with status and our latest reply. Owners and admins see the whole team's requests. |
| `search_help` | Searches the Answering Agent help center. |

Two tools change data:

| Tool | What it does |
| - | - |
| `update_task` | Changes one task's status, assignee, or both, the same as a change in the dashboard. The assignee gets the usual notification. Sending the same change again does nothing. |
| `add_task_note` | Adds an internal note to a task from a conversation. Only your team sees it. |

Neither tool contacts a customer. Your AI app decides when to ask before it runs a tool. Claude and ChatGPT ask you to approve a tool that changes data before it runs.

The MCP server and the [API](/api/overview) share the lookups for the account, conversations, tasks, contacts, and reports, so a report in Claude matches the same report over HTTP. They also share [task updates](/api/tasks#update-a-task) and [task notes](/api/tasks#add-a-note). Only the MCP server has `get_settings`, `list_support_requests`, and `search_help`. Only the API downloads call recordings and lists the metric catalog.

## Security

* You sign in with OAuth. The AI app never sees your password, and you need no API key.
* The AI app can look up your data, change a task's status or assignee, and add internal notes to tasks. It cannot change settings or message your customers.
* Claude and ChatGPT ask you before they run a tool that changes data.
* A connection works on one team and sees what you see in the dashboard. If your access is limited to some phone lines, so is the connection.
* A change runs as you, with your dashboard permissions. The task's activity shows it under your name.
* If you leave the team, or your role changes to one that cannot connect, the connection stops working on its next tool call.
* To disconnect, remove the server in your AI app.

For hosting, data retention, and compliance status, see [Security and data handling](/security).

## Connect another team

To use a different team, switch to that team in the dashboard, then connect again.

If you switch teams in the dashboard later, the connection for the earlier team stops working until you switch back.

## Limits

Each person can make 120 tool calls per minute, and changes count toward the same limit. Past that, the AI app gets "Too many requests" and the number of seconds to wait. This limit is separate from the API's.

## If something isn't working

| You see | Cause | Fix |
| - | - | - |
| "AI app connections aren't available for this account" | Your role is not owner, admin, or manager. | Ask a team owner or admin to change your role. |
| "This account can't use Answering Agent in AI apps right now" | The dashboard has a different team open than the one you connected, or your role changed. | Switch the dashboard back to the team you connected, or ask an owner or admin about your role. |
| "This connection request expired" | The sign-in request is no longer valid. | Start again from the AI app. |
| "Too many connection attempts" | You tried to connect too many times in a short period. | Wait a minute, then connect again from the AI app. |
| "Too many requests" | You made more than 120 tool calls in a minute. | Wait the number of seconds the message gives. |

## Let your coding agent read these docs

These docs have their own MCP server. It searches and reads the documentation, not your account data, and needs no sign-in. Add it to Claude Code, Cursor, or another coding agent so it can answer questions about the API while you build:

```
https://docs.answeringagent.com/mcp
```

Every page also has a menu at the top to copy it as Markdown or open it in Claude or ChatGPT.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.