> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# MCP: write tools, prompts, new metrics, and entity discovery

Several improvements have been shipped to the MCP Server.

**Write capabilities** are now available via the new `propose_change` tool, enabling AI assistants to create, update, and delete knowledge articles, custom instructions, and test cases, as well as trigger test runs. The tool uses a two-phase flow — call first to discover available fields, then again to apply the change. Knowledge articles are created in a disabled state by default to prevent unintended live impact.

**Containment metrics** are now available in `get_ada_metric` via two new metric types: `containment_rate` (percentage of conversations handled without escalating to a human agent) and `containment_volume` (count of those conversations).

**Conversation retrieval** has been improved with a new `get_conversations` tool that returns many conversations at either an `IDS_ONLY` or `SUMMARY` detail level — reducing token usage compared to fetching full transcripts. Individual conversation lookup via `get_conversation` now also returns a conversation summary, resolution status, and resolution reason alongside the full event log.

**Entity discovery** is now handled by a single `list_entities` tool, replacing the previous `list_channels` and `list_topics` tools and adding support for discovering conversation variables (`entity_type: 'variables'`).

**Built-in prompts** are now available in supported MCP clients. Two prompt templates ship with the MCP server: **My Agent Report** for a guided performance overview, and **Export Testing** for fetching and exporting test cases or test runs as CSV.

Learn more in the [MCP Server documentation](/mcp/introduction/overview).