MCP Server

The MDtoLink MCP server lets AI assistants publish and manage markdown documents on your behalf. Pick your editor below to get started in one command.

Install the skill (recommended)

For agents that support the Agent Skills standard (Claude Code, Cursor, Codex, and more):

npx skills add schedawg74/skills --skill mdtolink

This teaches your agent how to use MDtoLink without requiring MCP. For direct tool access (publish, list, update, delete via function calls), also install the MCP server below.

Quick install (MCP server)

Claude Code

claude mcp add mdtolink -e MDTOLINK_API_KEY=mdtolink_xxxxxxxxxxxx -- npx -y -p mdtolink mdtolink-mcp

Cursor / VS Code

npx -y -p mdtolink mdtolink-mcp

Open this link to install directly: Install in Cursor

Claude Desktop

Add to your config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "mdtolink": {
      "command": "npx",
      "args": ["-y", "-p", "mdtolink", "mdtolink-mcp"],
      "env": {
        "MDTOLINK_API_KEY": "mdtolink_xxxxxxxxxxxx"
      }
    }
  }
}

See the AI Agents section for more editors.

Authentication

Create an API key and pass it as MDTOLINK_API_KEY. If you’ve already run mdtolink login, the MCP server picks up your stored token automatically — no key needed.

Available tools

Tool	Description
publish	Publish markdown content to a shareable URL, or update an existing document
list_documents	List your published documents with metadata
get_document	Get a document with its full markdown content by ID
unpublish	Delete a published document by ID

publish

Parameter	Required	Description
content	Yes	Markdown content to publish
title	No	Document title (max 200 chars)
slug	No	Custom URL slug (Pro+ only)
documentId	No	Existing document ID to update
private	No	Make document private (Pro+ only)

list_documents

Parameter	Default	Description
limit	20	Number of documents (1-100)
offset	0	Number of documents to skip

get_document

Parameter	Required	Description
id	Yes	Document ID

unpublish

Parameter	Required	Description
id	Yes	Document ID to delete

Environment variables

Variable	Default	Description
MDTOLINK_API_KEY	—	API key for authentication
MDTOLINK_SERVER_URL	https://api.mdtolink.com	API server URL
MDTOLINK_APP_URL	https://app.mdtolink.com	Base URL for document links