MCP · Self-hosted

Bulk Blogger MCP

The Bulk Blogger engine, exposed as a Model Context Protocol tool.? Let your agent turn a backlog of Markdown? into a Squarespace-ready import — without ever opening a browser.

Runs on your machine · your content never leaves your computer

When would I use this?

This is the do-it-yourself version of Bulk Blogger. Instead of dragging files into a web page yourself, you set this up once on your own computer, and then your AI assistant (like Claude) can do the conversion for you whenever you ask — “turn this folder of posts into a Squarespace import file.” Everything runs on your machine, so your writing never leaves it. If this sounds like more setup than you want, the regular in-browser Bulk Blogger does the same job with nothing to install.

Run it on your machine

2 WAYS

With Docker?recommended

Needs Docker Desktop (or Docker Engine + Compose). Clone the repo and bring it up:

git clone https://github.com/jamesh-Pivotal/bulkblogger-mcp
cd bulkblogger-mcp
docker compose up

Without Docker

Needs Node? 18 or newer.

git clone https://github.com/jamesh-Pivotal/bulkblogger-mcp
cd bulkblogger-mcp
npm install
npm run mcp:serve

MCP endpoint http://localhost:3000/mcp

Connect your client

POINT IT AT LOCALHOST

Claude Desktop

Add it as a custom connector — no config file needed.

Open Connectors (the + menu in a chat).
Choose Add custom connector.
Paste http://localhost:3000/mcp and save.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "bulk-blogger": {
      "url": "http://localhost:3000/mcp",
      "type": "streamableHttp"
    }
  }
}

Claude.ai on the web won't work here. The browser app runs in the cloud and can't reach a server on your own computer. Use Claude Desktop, Cursor, or any local MCP-aware agent to connect to localhost?.

What it does

ONE TOOL

`convert_md_to_wxr`

Give it a batch of Markdown files (with YAML frontmatter?) and a small config — blog title, author, optional posting cadence — and it returns a single WordPress WXR? XML file, the only bulk-import format Squarespace accepts. One call = one feed = one blog.