AgentMD

io.github.djrobson5Published by GitHub account djrobson5v0.1.4Updated Oct 24, 2026

Convert PDF, DOCX, HTML, and URLs to clean, LLM-ready markdown with tables preserved

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFiles & Storage

Overview

AI-generated overview

AgentMD converts PDF, DOCX, HTML and web URLs into clean, LLM-ready markdown, with tables preserved, so an assistant can read documents it otherwise could not.

What you can do
Convert a web page or a document at an http(s) URL into markdown, extracting the main article and resolving links to absolute URLs, with tables preserved as GFM tables. Convert a document you already hold (PDF, DOCX, HTML, plain text) by passing its contents as base64. Read only part of a large document: PDF page ranges, a heading outline, a single section, or a token cap. Results come back as markdown prefixed with the detected title and any warnings.
When to use it
Useful when an assistant needs to ingest PDFs, Word files or web pages and the raw format is hard for a model to read. Good for research, summarization and extraction tasks where tables and article structure matter.
Requirements
A remote endpoint at the provider's site using streamable HTTP with an Authorization bearer header, or the local npm package agentmd-mcp run via npx or Docker over stdio. An AgentMD API key is required, supplied as AGENTMD_API_KEY or the Authorization header. AGENTMD_BASE_URL optionally points at a self-hosted or staging deployment. Network access is needed.
Before you install
The API key is a secret sent to the provider; keep it out of shared configs and images. Documents and URLs you submit are processed by a third-party service, so avoid confidential material. Usage is metered: 50 free conversions per email, then $0.002 per successful conversion billed monthly. Scanned or image-only PDFs return a warning rather than OCR text. Documents are limited to 25 MB.

Installation

In SourceWeft

  1. Open AgentMD in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.djrobson5%2Fagentmd/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "agentmd": {
      "type": "http",
      "url": "https://www.getagentmd.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

agentmd-mcp

MCP server for AgentMD — convert PDF, DOCX, HTML, and URLs into clean, LLM-ready markdown, with tables preserved and web-page boilerplate stripped.

Agents ingest documents constantly, and most document formats are hostile to language models. This gives your agent three tools that turn any of them into markdown it can actually read.

Install

Get a free API key (50 conversions, no card) at https://www.getagentmd.com — or fully programmatically:

bash
curl -X POST https://www.getagentmd.com/api/v1/keys/free \  -H "Content-Type: application/json" -d '{"email": "[email protected]"}'

Then:

Claude Code

bash
claude mcp add agentmd --env AGENTMD_API_KEY=<your-key> -- npx -y agentmd-mcp

Any MCP client (mcp.json / claude_desktop_config.json):

json
{  "mcpServers": {    "agentmd": {      "command": "npx",      "args": ["-y", "agentmd-mcp"],      "env": { "AGENTMD_API_KEY": "<your-key>" }    }  }}

Docker

bash
docker build -t agentmd-mcp .docker run -i --rm -e AGENTMD_API_KEY=<your-key> agentmd-mcp

The image runs the stdio server, so pass -i; the API key is supplied at run time with -e rather than baked into the image. To wire the container into an MCP client:

json
{  "mcpServers": {    "agentmd": {      "command": "docker",      "args": ["run", "-i", "--rm", "-e", "AGENTMD_API_KEY", "agentmd-mcp"],      "env": { "AGENTMD_API_KEY": "<your-key>" }    }  }}

Remote (no install) — the hosted server speaks streamable HTTP directly:

bash
claude mcp add --transport http agentmd https://www.getagentmd.com/api/mcp \  --header "Authorization: Bearer <your-key>"

Tools

ToolUse it for
convert_url_to_markdownA web page or a document at an http(s) URL
convert_file_to_markdownA document on the local filesystem, by path
convert_document_to_markdownDocument bytes you already hold, as base64

All three return markdown, prefixed with the detected title and any warnings.

Supported formats

  • PDF — text extraction (scanned/image-only PDFs return a warning; OCR is on the roadmap)
  • DOCX — headings, lists, and tables preserved
  • HTML / URLs — main-article extraction, GFM tables, links resolved to absolute URLs
  • Markdown / plain text — normalized passthrough

Limit: 25 MB per document.

Configuration

VariableRequiredPurpose
AGENTMD_API_KEYyesYour API key
AGENTMD_BASE_URLnoPoint at a different deployment (self-hosting, staging)

Pricing

First 50 conversions free (per email, no card). After that, $0.002 per successful conversion, billed monthly. No per-seat licensing — you pay for calls your agents actually make.

License

MIT (this client shim). The hosted service has its own terms.

Source: README.md at commit ee199de

Tools

2

convert_url_to_markdown

Convert URL to markdown

Fetch a URL (web page, PDF, DOCX, etc.) and convert it to clean, LLM-ready markdown. Extracts the main article content from web pages and preserves tables. Supports reading only part of a large document: PDF page ranges, a heading outline, a single section, or a token cap.

ParametersurlrequiredmodepagessectionmaxTokens

convert_document_to_markdown

Convert document to markdown

Convert a document you already have (PDF, DOCX, HTML, plain text) to clean, LLM-ready markdown. Pass the file contents as base64. Supports reading only part of a large document: PDF page ranges, a heading outline, a single section, or a token cap.

Parametersmodepagesbase64requiredsectionfilenamemaxTokens

Version history

2
  1. v0.1.4LatestSep 16, 2026
  2. v0.1.1Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts