Markovo CLI and MCP server

Markovo turns supported files and explicitlyauthorized public HTTPS pages into clean, structured Markdown. For thededicated web experience and product details, visit thePDF to Markdown Converter.

This public repository is the distribution source for the customer-sidemarkovo CLI and the markovo-mcp stdio MCP server. It contains no localconversion engine, backend service, deployment configuration, productioncredentials, or billing implementation. Conversion runs through theaccount-metered service at https://markovo.net.

Install

pip install markovo

Or run it without a permanent installation:

uvx markovo --help
uvx --from markovo markovo-mcp

API key and Credits

Create an API key in theDeveloper portal.
Store it in your shell or MCP host secret store; do not paste it intoprompts or commit it to source control.
Verify the setup:

export MARKOVO_API_KEY="your-key"
markovo doctor --json

Every conversion requires an explicit Credit ceiling. When a key ismissing, the client points to the Developer portal. When Credits areinsufficient, the service response points to thebilling page so the account can betopped up before retrying.

MCP configuration

{
  "mcpServers": {
    "markovo": {
      "command": "uvx",
      "args": ["--from", "markovo", "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 orenvironment-variable settings. The key and service origin are never MCPtool arguments, so prompts cannot redirect the credential. The publicclient accepts only https://markovo.net and does not follow authenticatedredirects.

The MCP server can read and write only within the requiredMARKOVO_MCP_ROOT. Set it to the smallest dedicated project directoryyour 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 andto Billing when Credits are insufficient.

Security

Report security issues privately using the instructions inSECURITY.md.Do not include API keys, customer documents,or private conversion results in a public issue.

Markovo CLI and MCP server