Markovo File to Text, Word and Markdown

io.github.fisher-bytePublished by GitHub account fisher-bytev0.1.2Updated Nov 6, 2026

Convert files and authorized public HTTPS pages to text, editable Word or Markdown.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFiles & Storage

Overview

AI-generated overview

Markovo converts supported files and authorized public HTTPS pages into text, editable Word, or Markdown through a metered cloud service.

What you can do
  • Convert local files or one explicitly authorized public HTTPS page into text, Word, or Markdown
  • Check remote job status and list manifest-verified image assets from a finished job
  • Create and revoke short-lived bearer links for result images, and verify downloaded bundles
  • Inspect account Credit usage, live capabilities, billing link, and client/service/API-key readiness
When to use it
Useful when an assistant needs to turn PDFs, documents, images, audio, or video into readable text, Word, or Markdown, or to fetch a public web page as structured content, without running a local conversion engine.
Requirements
Remote Streamable HTTP endpoint with OAuth 2.1 sign-in, or the local stdio package run via uvx (Python). Local mode needs MARKOVO_API_KEY from the Markovo developer portal and a dedicated MARKOVO_MCP_ROOT directory; a Markovo account with Credits is required for conversions.
Before you install
Conversions are account-metered and consume Credits; the service never tops up or changes plans automatically. The API key must be kept in the host secret store, not in prompts. Local file tools are bounded by MARKOVO_MCP_ROOT and fail closed if it is missing. URL conversion sends the page to Markovo's remote fetch, and asset links are temporary bearer URLs.

Installation

In SourceWeft

  1. Open Markovo File to Text, Word and Markdown in the dashboard and add it to a workspace.
  2. Connect the required 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.fisher-byte%2Fmarkovo/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. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "markovo-file-to-text-word-and-markdown": {
      "type": "http",
      "url": "https://markovo.net/mcp"
    }
  }
}

README

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.

Install

bash
pip install "markovo==0.1.2"

Or run it without a permanent installation:

bash
uvx --from "markovo==0.1.2" markovo --helpuvx --from "markovo==0.1.2" markovo-mcp

Output formats

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

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:
bash
export MARKOVO_API_KEY="your-key"markovo doctor --json

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

MCP configuration

Remote MCP (recommended for hosted agents)

Connect the Streamable HTTP endpoint:

text
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

json
{  "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.

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

Links

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.

Source: README.md at commit 32bef6c

Tools

11

markovo_convert

Convert a supported file through the account-metered Markovo API.

Parametersmodeout_dirrequiredinput_pathrequiredmax_creditscapability_iddownload_formatlayout_fidelity

markovo_convert_url

Convert one public HTTPS page after explicit consent to Markovo's isolated remote fetch.

Parametersurlrequiredout_dirrequiredmax_creditspoll_attemptsdownload_formataccept_remote_fetchrequiredpoll_interval_seconds

markovo_job_status

Fetch a remote job.

Parametersjob_id

markovo_job_assets

List manifest-verified image assets for a completed job.

Parametersjob_id

markovo_asset_url

Create a revocable 60-600 second bearer URL for one Bundle image.

Parametersjob_idasset_pathexpires_in_seconds

markovo_asset_revoke

Revoke a temporary asset URL before it expires.

Parametersjob_idgrant_id

markovo_usage

Fetch account Credit usage.

Takes no parameters.

markovo_capabilities

Fetch the live capability registry.

Takes no parameters.

markovo_billing

Return the secure billing URL.

Takes no parameters.

markovo_bundle_verify

Verify a downloaded Markovo bundle.

Parametersbundle

markovo_doctor

Check client, service, and API-key readiness.

Takes no parameters.

Version history

2
  1. v0.1.2LatestOct 30, 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 listed15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts