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

# Agents MCP Tools

> Use DialNexa agents MCP tools through the remote MCP server.

DialNexa agents MCP tools let an MCP-compatible AI client create, inspect, configure, and remove voice agents. Each tool page includes its exact server description, input schema, safety level, request shape, and retry guidance.

## Available Agents MCP Tools

| Tool                                                                           | Safety                              | What it does                                                                                                                                                          |
| ------------------------------------------------------------------------------ | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`list_agents`](/docs/mcp-tools/agents/list-agents)                                 | Read only                           | Returns all voice agents configured for the organization, including their names and IDs.                                                                              |
| [`get_agent`](/docs/mcp-tools/agents/get-agent)                                     | Read only                           | Returns full configuration for a single agent by ID (e.g. agent\_abc123), including all versions with their functions, pronunciations, and post-call analysis config. |
| [`create_agent`](/docs/mcp-tools/agents/create-agent)                               | Changes state - verify before retry | Creates a new voice agent for the organization.                                                                                                                       |
| [`update_agent`](/docs/mcp-tools/agents/update-agent)                               | Changes state - verify before retry | Updates a specific DRAFT version of an existing agent's configuration.                                                                                                |
| [`delete_agent`](/docs/mcp-tools/agents/delete-agent)                               | Destructive                         | Permanently deletes an agent.                                                                                                                                         |
| [`list_agent_versions`](/docs/mcp-tools/agents/list-agent-versions)                 | Read only                           | Returns all versions of a given agent, given its agent\_id.                                                                                                           |
| [`get_agent_version`](/docs/mcp-tools/agents/get-agent-version)                     | Read only                           | Returns full configuration for a single version of an agent, given its agent\_id and version\_number, including functions, voice, LLM, and transcriber config.        |
| [`list_agent_functions`](/docs/mcp-tools/agents/list-agent-functions)               | Read only                           | Returns the tool/function definitions (e.g. transfer call, book appointment, custom API calls) configured on a specific agent version.                                |
| [`get_agent_builder_inventory`](/docs/mcp-tools/agents/get-agent-builder-inventory) | Read only                           | Returns the catalog of building blocks available to the agent builder, LLMs, transcribers, languages, and other resolver options usable when configuring an agent.    |

## Before you call a tool

Connect with OAuth or a workspace API key and complete MCP initialization first. Use IDs exactly as another DialNexa tool returned them, including prefixes such as `agent_`, `call_`, and `workflow_`.

For operations that change data, verify the target and current state before the call. Billable and destructive tools require extra care because retrying an uncertain result can spend money or repeat an irreversible action.

## Related guides

* [MCP quickstart](/docs/mcp-tools/quickstart)
* [MCP responses and errors](/docs/mcp-tools/errors)
* [MCP connection and authentication](/docs/mcp-tools/overview)