English Français العربية

Markovo File to Markdown

Official registry Productivity

Convert files and authorized public HTTPS pages to Markdown with secure job and billing guidance.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http markovo-file-to-markdown 'https://markovo.net/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "markovo-file-to-markdown": {
            "type": "http",
            "url": "https://markovo.net/mcp"
        }
    }
}
PYPI package markovo
Claude Code 
claude mcp add markovo-file-to-markdown -e 'MARKOVO_API_KEY=<your markovo_api_key>' -e 'MARKOVO_MCP_ROOT=<MARKOVO_MCP_ROOT>' -- uvx markovo==0.1.1 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "markovo-file-to-markdown": {
            "command": "uvx",
            "args": [
                "markovo==0.1.1",
                "mcp"
            ],
            "env": {
                "MARKOVO_API_KEY": "<your markovo_api_key>",
                "MARKOVO_MCP_ROOT": "<MARKOVO_MCP_ROOT>"
            }
        }
    }
}

Environment variables

  • MARKOVO_API_KEY required secret Create a key at https://markovo.net/app#developer. Store it in the MCP host secret store; do not paste it into prompts.
  • MARKOVO_MCP_ROOT required Dedicated existing directory that bounds all MCP file reads and writes. File tools fail closed when it is missing.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Markovo CLI and MCP server
  2. Install
  3. API key and Credits
  4. MCP configuration
  5. Links
  6. Found a conversion issue?
  7. Security

Markovo CLI and MCP server

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.

Install

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-mcp

API key and Credits

  1. Create an API key in the Developer portal.
  2. Store it in your shell or MCP host secret store; do not paste it into prompts or commit it to source control.
  3. Verify the setup:
export MARKOVO_API_KEY="your-key"
markovo doctor --json

Every 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.

MCP configuration

Connect the Streamable HTTP endpoint:

https://markovo.net/mcp

The 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.

Local stdio MCP
{
  "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.

Found a conversion issue?

Report a reproducible case to support@markovo.net. If we confirm and fix it, you'll receive 1 month of Markovo Pro.

Security

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.

Frequently asked questions

What is Markovo File to Markdown?

Convert files and authorized public HTTPS pages to Markdown with secure job and billing guidance.

How do I install Markovo File to Markdown?

It runs as a remote server. In Claude Code: claude mcp add --transport http markovo-file-to-markdown 'https://markovo.net/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Markovo File to Markdown need an API key?

Yes. It expects MARKOVO_API_KEY, MARKOVO_MCP_ROOT, which you set in its configuration.

Is Markovo File to Markdown open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Markovo File to Markdown?

It is published by fisher-byte. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.