
Public distribution for the Markovo CLI and MCP server
Public distribution for the Markovo CLI and MCP server
·
Markovo turns supported files and explicitly authorized public HTTPS pages into readable text, editable Word, or 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.2"Or run it without a permanent installation:
uvx --from "markovo==0.1.2" markovo --help
uvx --from "markovo==0.1.2" markovo-mcpCLI 0.1.2+ accepts --download-format md, docx, or txt on file
and URL conversions; the existing default is a verified Markdown ZIP
bundle. Local stdio MCP uses the download_format argument. Hosted
Remote MCP uses output_format. All formats reuse the same account
and one conversion; downloading another format does not charge again.
Files above 8MiB use bounded R2 upload parts instead of one full-file
memory buffer. Image/document/audio limits are 25MiB on Free and
50MiB on Starter or Pro. Video limits are 200MiB/1h, 700MiB/2h and
2GiB/2h. Upgrade advice is returned only when a higher plan can accept
the input; otherwise compress or split the file before retrying.
export MARKOVO_API_KEY="your-key"
markovo doctor --jsonCLI and local stdio MCP use a 15-Credit convenience safety ceiling when their Credit limit is omitted. REST and direct client calls still require 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.2", "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.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add markovo -- uvx --from markovo==0.1.2 markovo-mcp{
"mcpServers": {
"markovo": {
"env": {
"MARKOVO_API_KEY": "",
"MARKOVO_MCP_ROOT": ""
},
"args": [
"--from",
"markovo==0.1.2",
"markovo-mcp"
],
"command": "uvx"
}
}
}code --add-mcp '{"name":"markovo","env":{"MARKOVO_API_KEY":"","MARKOVO_MCP_ROOT":""},"args":["--from","markovo==0.1.2","markovo-mcp"],"command":"uvx"}'[mcp_servers.markovo]
command = "uvx"
args = ["--from", "markovo==0.1.2", "markovo-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/markovo-cli-and-mcp-server to learn what the "Markovo CLI and MCP server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
pip install "markovo==0.1.2"uvx --from "markovo==0.1.2" markovo --help
uvx --from "markovo==0.1.2" markovo-mcpThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/markovo-cli-and-mcp-server)Nothing comparable is listed yet.
v0.1.0Markovo 0.1.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "markovo-cli-and-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.