# MCP tools

Canonical: https://heedit.ai/docs/connections/mcp/
Language: en

MCP is an Agent-to-Heedit execution channel. A Skill can explain the protocol, but it cannot replace a connected MCP server.

## Start with capabilities

Call get_capabilities first. Then use open_document or list_documents, followed by the smallest content-reading action needed. Markdown context, selection and outline reads require user confirmation for each request.

```
get_capabilities
open_document / list_documents
list_inbox_files / read_inbox_files / record_inbox_delivery
get_context_packet / get_selection / get_outline
reveal / highlight
export_document
```

## Know what MCP does not do

export_document can export a confirmed Markdown revision to PDF after the output path is approved. revise_selection is currently unavailable, and Heedit MCP does not provide a general file-write tool; an Agent edits files through its own authorized environment. Annotations use list_annotations, get_annotation and register_output, or the equivalent heedit annotations commands.