api

API Documentation

This directory contains technical API documentation for the MarkItDown MCP server.

Available Tools

convert_file

Convert a single file to markdown format.

Parameters:

• file_path (string, optional): Path to the file to convert
• file_content (string, optional): Base64-encoded file content
• filename (string, required if using file_content): Original filename

Returns:

• content: Array of content blocks with converted markdown

convert_directory

Convert all supported files in a directory to markdown.

Parameters:

• input_directory (string, required): Path to input directory
• output_directory (string, optional): Path to output directory

Returns:

• content: Summary of conversion results

list_supported_formats

List all supported file formats for conversion.

Parameters: None

Returns:

• content: List of supported file formats and descriptions

MCP Protocol Implementation

The server implements MCP protocol version 2024-11-05 with the following capabilities:

Server Info

{
  "name": "markitdown-server",
  "version": "1.0.0"
}

Capabilities

{
  "tools": {}
}

Error Handling

The server returns standard MCP error responses:

Common Error Codes

• -32601: Method not found
• -32602: Invalid params
• -32603: Internal error

Tool-Specific Errors

• File not found
• Permission denied
• Unsupported format
• Conversion failed

Security Features

• Path traversal protection
• Safe directory restrictions
• Temporary file cleanup
• Request size limits
• DoS protection

Performance Considerations

• Memory usage optimization
• Large file handling
• Concurrent request management
• Resource cleanup