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

# MCP overview

> Build and tune voice agents by talking to Claude or Codex.

The Placetel MCP server connects your AI assistant to your account. You
describe the phone assistant you want; the assistant creates it, writes the
instructions, picks the settings and adds tools, and asks you before every
change.

## What a session looks like

You connect your client and paste the [start prompt](https://aipro.placetel.de/docs/en/mcp/quickstart.md#2-start-with-this-prompt).
Then you describe the agent you want, in your own words:

> Build a reception agent for a dental practice. It should greet callers, take
> appointment requests with name, phone number and preferred time, and hand
> over to a human for emergencies. Formal address, calm tone.

The assistant then

1. lists your existing agents and reads the two guides,
2. creates the agent and shows you the draft instructions for review,
3. sets the greeting, language, voice and conversation style one setting at a
   time, showing you each change and its side effects,
4. tells you what is left: connect a phone number in the dashboard and make a
   test call.

Ten minutes later you call the number and talk to the agent. If something is
off, you say so and the assistant adjusts the setting.

## What you can do

* **Voice agents:** create, read, delete; change instructions, greeting,
  voice, language and knowledge-base settings.
* **Tools:** create API tools and supported integration tools, enable them per
  agent, run one for testing.
* **Conversations:** list past calls with filters, read transcripts, and fix
  the agent or a tool based on what you find.

## Get started

1. [Authentication](https://aipro.placetel.de/docs/en/mcp/authentication.md) and [Quickstart](https://aipro.placetel.de/docs/en/mcp/quickstart.md): token, connect, start prompt.
2. [Build a voice agent](https://aipro.placetel.de/docs/en/mcp/voice-agents.md), then [add tools](https://aipro.placetel.de/docs/en/mcp/tools.md).
3. [Monitor and improve](https://aipro.placetel.de/docs/en/mcp/monitoring.md) from real calls.

Every MCP tool and the scopes it needs are listed in the
[tool reference](https://aipro.placetel.de/docs/en/mcp/tool-reference.md).

## Two kinds of tools

An **MCP tool** such as `create_tool` is what your AI assistant calls to manage
your account. A **voice-agent tool** is a function your phone assistant uses
during a call, for example to look up an appointment. To connect your own MCP
server to a voice agent instead, see [Custom MCP Server](https://aipro.placetel.de/docs/en/mcp-server.md).


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