{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_m5e8wjbjqqmm","handle":"markitdown-mcp","url":"https://wellknown.network/agents/markitdown-mcp","links":{"self":"https://wellknown.network/agents/markitdown-mcp/record.json","html":"https://wellknown.network/agents/markitdown-mcp","markdown":"https://wellknown.network/agents/markitdown-mcp/record.md","api":"https://wellknown.network/api/v1/agents/markitdown-mcp","status":"https://wellknown.network/api/v1/agents/markitdown-mcp/status","claim":"https://wellknown.network/agents/markitdown-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/markitdown-mcp/claim.json","badge":"https://wellknown.network/agents/markitdown-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/markitdown-mcp/history","tools":"https://wellknown.network/api/v1/agents/markitdown-mcp/tools"},"ard":{"identifier":"urn:air::server:markitdown-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"markitdown-mcp","summary":"An MCP server for the \"markitdown\" library.","description":"# MarkItDown-MCP\n\n> [!IMPORTANT]\n> The MarkItDown-MCP package is meant for **local use**, with local trusted agents. In particular, when running the MCP server with Streamable HTTP or SSE, it binds to `localhost` by default, and is not exposed to other machines on the network or Internet. In this configuration, it is meant to be a direct alternative to the STDIO transport, which may be more convenient in some cases. DO NOT bind the server to other interfaces unless you understand the [security implications](#security-considerations) of doing so.\n\n[![PyPI](https://img.shields.io/pypi/v/markitdown-mcp.svg)](https://pypi.org/project/markitdown-mcp/)\n![PyPI - Downloads](https://img.shields.io/pypi/dd/markitdown-mcp)\n[![Built by AutoGen Team](https://img.shields.io/badge/Built%20by-AutoGen%20Team-blue)](https://github.com/microsoft/autogen)\n\nThe `markitdown-mcp` package provides a lightweight STDIO, Streamable HTTP, and SSE MCP server for calling MarkItDown.\n\nIt exposes one tool: `convert_to_markdown(uri)`, where uri can be any `http:`, `https:`, `file:`, or `data:` URI.\n\n## Installation\n\nTo install the package, use pip:\n\n```bash\npip install markitdown-mcp\n```\n\n## Usage\n\nTo run the MCP server, using STDIO (default), use the following command:\n\n```bash\nmarkitdown-mcp\n```\n\nTo run the MCP server, using Streamable HTTP and SSE, use the following command:\n\n```bash\nmarkitdown-mcp --http --host 127.0.0.1 --port 3001\n```\n\n## Running in Docker\n\nTo run `markitdown-mcp` in Docker, build the Docker image using the provided Dockerfile:\n```bash\ndocker build -t markitdown-mcp:latest .\n```\n\nAnd run it using:\n```bash\ndocker run -it --rm markitdown-mcp:latest\n```\nThis will be sufficient for remote URIs. To access local files, you need to mount the local directory into the container. For example, if you want to access files in `/home/user/data`, you can run:\n\n```bash\ndocker run -it --rm -v /home/user/data:/workdir markitdown-mcp:latest\n```\n\nOnce mounted, all files under data will be acces…","publisher":null,"homepage":"https://github.com/microsoft/markitdown#readme","repository":"https://github.com/microsoft/markitdown#readme","version":"0.0.1a8","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:markitdown-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"markitdown-mcp","registry":"pypi","observedAt":"2026-11-03T11:24:52.723Z","publishedAt":"2026-10-21T19:41:56.970045Z","latestVersion":"0.0.1a8"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"markitdown-mcp","url":"https://pypi.org/project/markitdown-mcp/","firstSeenAt":"2026-09-10T00:22:51.366Z","fetchedAt":"2026-11-03T11:24:03.145Z","normalizedAt":"2026-11-03T11:24:03.145Z"}]},"firstSeenAt":"2026-09-10T00:22:51.366Z","updatedAt":"2026-11-03T11:24:52.723Z"}