bulkpublish

BulkPublish AI Toolkit

Connect your AI assistant to BulkPublish — schedule posts, manage channels, upload media, and track analytics across 11 social media platforms, all from your AI tool of choice.

What You Get

29 MCP tools covering the full BulkPublish API:

Category	Tools	Examples
Posts	10	Create, schedule, publish, retry, delete, bulk actions, metrics
Channels	4	List accounts, health check, platform options, @mention search
Media	4	Upload (URL), list, get, delete
Labels	4	Create, list, update, delete
Schedules	4	Create recurring schedules, update, list, delete
Analytics	1	Summary by date range with per-platform breakdown
Quota	1	Plan usage and limits
Queue	1	Next optimal posting slot

Supported platforms: Facebook, Instagram, X/Twitter, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon

Prerequisites

• Node.js 18+ (for running the MCP server via npx)
• BulkPublish API key — get one at app.bulkpublish.com/developer

---

Quick Install

Three ways to get started — pick what fits your workflow:

# 1. Claude Code Plugin (recommended — auto-updates, includes skills)
/plugin marketplace add azeemkafridi/bulkpublish-ai-toolkit
/plugin install bulkpublish@bulkpublish-ai-toolkit

# 2. Agent Skills (works with 41+ agents — Claude Code, Cursor, Codex, Copilot, etc.)
npx skills add azeemkafridi/bulkpublish-ai-toolkit

# 3. MCP Server (any MCP-compatible tool)
claude mcp add bulkpublish -- npx -y @bulkpublish/mcp-server

---

Setup by Tool

Claude Code

Option A — Plugin (recommended, auto-updates):

/plugin marketplace add azeemkafridi/bulkpublish-ai-toolkit
/plugin install bulkpublish@bulkpublish-ai-toolkit

You'll be prompted for your API key during installation.

Option B — Agent Skills:

npx skills add azeemkafridi/bulkpublish-ai-toolkit

Or install a single skill:

npx skills add azeemkafridi/bulkpublish-ai-toolkit --skill schedule-post

Option C — MCP only:

claude mcp add bulkpublish -- npx -y @bulkpublish/mcp-server

Then set your API key:

export BULKPUBLISH_API_KEY=bp_your_key_here

---

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "bulkpublish": {
      "command": "npx",
      "args": ["-y", "@bulkpublish/mcp-server"],
      "env": {
        "BULKPUBLISH_API_KEY": "bp_your_key_here"
      }
    }
  }
}

Restart Claude Desktop to activate.

---

Cursor

Option A — Agent Skills:

npx skills add azeemkafridi/bulkpublish-ai-toolkit -a cursor

Option B — MCP config. Create or edit .cursor/mcp.json in your project root (or globally at ~/.cursor/mcp.json):

{
  "mcpServers": {
    "bulkpublish": {
      "command": "npx",
      "args": ["-y", "@bulkpublish/mcp-server"],
      "env": {
        "BULKPUBLISH_API_KEY": "bp_your_key_here"
      }
    }
  }
}

---

Windsurf

Option A — Agent Skills:

npx skills add azeemkafridi/bulkpublish-ai-toolkit -a windsurf

Option B — MCP config. Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "bulkpublish": {
      "command": "npx",
      "args": ["-y", "@bulkpublish/mcp-server"],
      "env": {
        "BULKPUBLISH_API_KEY": "${env:BULKPUBLISH_API_KEY}"
      }
    }
  }
}

Set your key in your shell environment:

export BULKPUBLISH_API_KEY=bp_your_key_here

Or hardcode it directly in the env block above.

---

VS Code (GitHub Copilot)

Option A — Agent Skills:

npx skills add azeemkafridi/bulkpublish-ai-toolkit -a github-copilot

Option B — MCP config. Add to your VS Code settings.json (Cmd+Shift+P > "Preferences: Open User Settings (JSON)"):

{
  "mcp": {
    "servers": {
      "bulkpublish": {
        "command": "npx",
        "args": ["-y", "@bulkpublish/mcp-server"],
        "env": {
          "BULKPUBLISH_API_KEY": "bp_your_key_here"
        }
      }
    }
  }
}

---

Gemini CLI

Option A — CLI command:

gemini mcp add bulkpublish -- npx -y @bulkpublish/mcp-server

Option B — Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "bulkpublish": {
      "command": "npx",
      "args": ["-y", "@bulkpublish/mcp-server"],
      "env": {
        "BULKPUBLISH_API_KEY": "$BULKPUBLISH_API_KEY"
      }
    }
  }
}

Set your key:

export BULKPUBLISH_API_KEY=bp_your_key_here

---

OpenAI Codex CLI

Option A — Agent Skills:

npx skills add azeemkafridi/bulkpublish-ai-toolkit -a codex

Option B — CLI command: