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

Run it on your machine

2 WAYS

With Dockerrecommended

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.