Mcp Prompt Agent.doc

# `Mcp_prompt_agent` – wrap a *ChatMD* file as an MCP **tool** and **prompt**

> Phase-1 / Phase-2 server helper – requires the *server-core* registry to be
> available.

`Mcp_prompt_agent` is a tiny bridge between a *static* `*.chatmd` document and
the runtime entities understood by an MCP server:

| Artefact | Where it is used | Value returned by [`of_chatmd_file`](#val-of_chatmd_file) |
|----------|-----------------|----------------------------------------|
| **Tool metadata** (`Mcp_types.Tool.t`) | advertised by `"tools/list"`; invoked through `"tools/call"` | *1st component* |
| **Tool handler** (`Mcp_server_core.tool_handler`) | executes on every `"tools/call"` | *2nd component* |
| **Prompt** (`Mcp_server_core.prompt`) | listed by `"prompts/list"`, fetched via `"prompts/get"` | *3rd component* |

All three objects are derived from the file name and contents of the
`*.chatmd` document – no extra annotations are required inside the file.

---

## High-level workflow