Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@markovo-mcp Convert 'docs/report.pdf' to Markdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Markovo turns supported files and explicitly authorized public HTTPS pages into clean, structured Markdown. For the dedicated web experience and product details, visit the PDF to Markdown Converter.
This public repository is the distribution source for the customer-side
markovo CLI and the markovo-mcp stdio MCP server. It contains no local
conversion engine, backend service, deployment configuration, production
credentials, or billing implementation. Conversion runs through the
account-metered service at https://markovo.net.
pip install "markovo==0.1.1"Or run it without a permanent installation:
uvx --from "markovo==0.1.1" markovo --help
uvx --from "markovo==0.1.1" markovo-mcpRelated MCP server: MarkItDown MCP Server
Create an API key in the Developer portal.
Store it in your shell or MCP host secret store; do not paste it into prompts or commit it to source control.
Verify the setup:
export MARKOVO_API_KEY="your-key"
markovo doctor --jsonEvery conversion requires an explicit Credit ceiling. When a key is missing, the client points to the Developer portal. When Credits are insufficient, the service response points to the billing page so the account can be topped up before retrying.
Connect the Streamable HTTP endpoint:
https://markovo.net/mcpThe MCP host discovers Markovo's OAuth 2.1 metadata, opens the Markovo
account sign-in and consent screen, and stores its own scoped token. You
do not create, paste, or share an API key for this remote connection.
Remote tools can inspect capabilities, Credits, and owned jobs; convert
one explicitly supplied public HTTPS page with a required
max_credit_units ceiling; and create or revoke short-lived result-image
links. Remote MCP cannot read local files. Use the stdio package below or
REST multipart upload when a local file must be converted.
Markovo never tops up Credits or changes a plan automatically. A low balance response points to https://markovo.net/app#billing and waits for the account owner to act.
{
"mcpServers": {
"markovo": {
"command": "uvx",
"args": ["--from", "markovo==0.1.1", "markovo-mcp"],
"env": {
"MARKOVO_API_KEY": "${MARKOVO_API_KEY}",
"MARKOVO_MCP_ROOT": "/path/to/safe/project"
}
}
}
}MCP clients should inject MARKOVO_API_KEY through their secret or
environment-variable settings. The key and service origin are never MCP
tool arguments, so prompts cannot redirect the credential. The public
client accepts only https://markovo.net and does not follow authenticated
redirects.
The MCP server can read and write only within the required
MARKOVO_MCP_ROOT. Set it to the smallest dedicated project directory
your MCP host needs. If it is missing, the server refuses all file tools;
parent-directory and symlink escapes are rejected.
export MARKOVO_MCP_ROOT="/path/to/safe/project"Structured errors point to the Developer portal when a key is missing and to Billing when Credits are insufficient.
Report security issues privately using the instructions in SECURITY.md. Do not include API keys, customer documents, or private conversion results in a public issue.
This server cannot be deployed
Convert documents and web pages to clean Markdown: PDF, DOCX, XLSX, EPUB, scanned files, any URL.
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Convert files, URLs, and documents to clean, AI-ready Markdown via MCP.
Parse PDF/Word/PPT/HTML to Markdown; tables as JSON, image extraction, RAG chunking, page ranges.
