Markdown Anything

Connect AI assistants like Claude to Markdown Anything using the Model Context Protocol (MCP) for direct file-to-Markdown conversion.

The Model Context Protocol (MCP) server lets AI assistants convert files to Markdown directly — no manual API calls required. Any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Windsurf, etc.) can discover and invoke conversion tools automatically.

POST https://markdownanything.com/mcp/conversions

The MCP server uses the same workspace API tokens as the REST API. Credits are charged identically.

Available Tools

The server exposes four tools:

Tool	Description
`convert-file`	Convert a base64-encoded file to Markdown
`get-conversion`	Retrieve the status and result of a past conversion
`check-credits`	Check your workspace credit balance and plan info
`list-supported-formats`	List all supported file formats and size limits

Setup

Add the following to your claude_desktop_config.json:

{
    "mcpServers": {
        "markdown-anything": {
            "type": "streamable-http",
            "url": "https://markdownanything.com/mcp/conversions",
            "headers": {
                "Authorization": "Bearer mda_your_token_here"
            }
        }
    }
}

Add to your project's .mcp.json:

{
    "mcpServers": {
        "markdown-anything": {
            "type": "streamable-http",
            "url": "https://markdownanything.com/mcp/conversions",
            "headers": {
                "Authorization": "Bearer mda_your_token_here"
            }
        }
    }
}

Add to your Cursor MCP settings (.cursor/mcp.json):

{
    "mcpServers": {
        "markdown-anything": {
            "type": "streamable-http",
            "url": "https://markdownanything.com/mcp/conversions",
            "headers": {
                "Authorization": "Bearer mda_your_token_here"
            }
        }
    }
}

Replace mda_your_token_here with a real API token from Settings > API Tokens in your workspace dashboard.

Tools Reference

convert-file

Convert a file to Markdown. Send the file content as a base64-encoded string.

Prop

Type

Response — JSON with:

{
    "conversion_id": "9e5fcd8a-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
    "markdown": "# My Document\n\nConverted content here...",
    "credits_used": 1,
    "credits_remaining": 499
}

On error, the tool returns an error message and automatically refunds any charged credits.

get-conversion

Retrieve the status and result of a previous conversion. Read-only.

Prop

Type

Response — JSON with status (pending, processing, completed, or failed), markdown content (when completed), and error details (when failed).

check-credits

Check the current workspace credit balance, plan, and conversion costs. No parameters required. Read-only.

Response:

{
    "balance": 487,
    "plan": "Professional",
    "credit_costs": {
        "standard": 1,
        "enhanced_ai": 2
    },
    "can_use_enhanced_ai": true
}

list-supported-formats

List all supported file formats grouped by category. No parameters required. Read-only.

Response:

{
    "formats": {
        "documents": ["pdf", "docx", "doc", "rtf", "odt", "epub", "txt", "md", "markdown"],
        "spreadsheets": ["xlsx", "xls", "csv", "ods"],
        "presentations": ["pptx", "ppt", "odp"],
        "web": ["html", "htm", "xml", "json"],
        "images": ["jpg", "jpeg", "png"],
        "audio": ["wav", "mp3", "m4a"]
    },
    "max_file_size_mb": 10
}

Credit Costs

Credit costs are identical to the REST API:

Conversion Type	Credit Cost
Standard	1 credit
Enhanced AI (Starter)	3 credits
Enhanced AI (Professional / Business)	2 credits

Usage Examples

Once configured, your AI assistant can use Markdown Anything tools conversationally:

"Convert this PDF to Markdown" — the assistant reads the file, base64-encodes it, and calls convert-file
"How many credits do I have left?" — calls check-credits
"What file types can you convert?" — calls list-supported-formats
"Show me the result of conversion abc-123" — calls get-conversion

Authentication

The MCP server uses the same Bearer token authentication as the REST API. Tokens are scoped to a workspace — credits, conversions, and rate limits all apply at the workspace level.

Next Steps

Authentication — Create and manage API tokens
Credits & Billing — Understand plans, overages, and billing cycles
Supported Formats — Full list of 25+ supported file types
REST API — Alternative HTTP API for programmatic access

MCP Server