From 46f973adda25a5c825d88ef861ca4bd2683e440a Mon Sep 17 00:00:00 2001 From: Ricardo Accioly Date: Thu, 16 Jul 2026 12:50:17 -0400 Subject: [PATCH] docs: add 'Use with AI Agents' section to README Points readers to the official markitdown-mcp server and to community-maintained Agent Skills for CLI coding agents (ref #1810). Co-Authored-By: Claude Fable 5 --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index aa2f58bb8..124f76c70 100644 --- a/README.md +++ b/README.md @@ -287,6 +287,17 @@ docker build -t markitdown:latest . docker run --rm -i markitdown:latest < ~/your-file.pdf > output.md ``` +### Use with AI Agents + +To use MarkItDown from AI applications and agents: + +- **MCP server** — [`packages/markitdown-mcp`](packages/markitdown-mcp) provides an official Model Context Protocol server exposing MarkItDown as a tool (e.g., for Claude Desktop). +- **Agent Skills (community)** — for CLI-based coding agents (Claude Code and other agents supporting the [Agent Skills](https://agentskills.io) format), community-maintained skills teach the agent to invoke the `markitdown` CLI when reading documents: + - [coroboros/agent-skills](https://github.com/coroboros/agent-skills) (see [#1810](https://github.com/microsoft/markitdown/issues/1810)) + - [raccioly/markitdown-skill](https://github.com/raccioly/markitdown-skill) + +Community tools are not maintained or endorsed by the MarkItDown team. + ## Contributing This project welcomes contributions and suggestions. Most contributions require you to agree to a