markdownbin-mcp-server

MCP (Model Context Protocol) server for MarkdownBin. Lets AI agents create and retrieve markdown pastes with shareable links.

Quick Setup

Claude Code

Add to ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "markdownbin": {
      "command": "npx",
      "args": ["-y", "markdownbin-mcp-server"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "markdownbin": {
      "command": "npx",
      "args": ["-y", "markdownbin-mcp-server"]
    }
  }
}

Claude Desktop

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

{
  "mcpServers": {
    "markdownbin": {
      "command": "npx",
      "args": ["-y", "markdownbin-mcp-server"]
    }
  }
}

Tools

create_paste

Create a new markdown paste and get a shareable link.

Input:

• markdown (string, required) — The markdown content to paste (max 500KB). Supports all standard markdown features plus Mermaid diagrams.

Output: Paste URL and ID.

get_paste

Retrieve an existing paste by ID.

Input:

• id (string, required) — The paste ID (10-character string).

Output: Paste metadata and markdown content.

Configuration

Set MARKDOWNBIN_URL environment variable to point to a different MarkdownBin instance:

{
  "mcpServers": {
    "markdownbin": {
      "command": "npx",
      "args": ["-y", "markdownbin-mcp-server"],
      "env": {
        "MARKDOWNBIN_URL": "https://your-instance.example.com"
      }
    }
  }
}

Default: https://gomarkdown.online

API

This MCP server uses the MarkdownBin HTTP API:

• POST /api/paste — Create a paste
• GET /api/paste/:id — Retrieve a paste

Interactive API docs: gomarkdown.online/api/docs

OpenAPI spec: gomarkdown.online/api/openapi.json

License

MIT