Getting Started with the BPAI MCP Server

Prerequisites

• Node.js 18+ installed on your machine
• A Bulk Publishing AI account with an active subscription
• At least one AI provider API key configured in your account settings
• An MCP-compatible client (Antigravity, Claude Desktop, Cursor, Windsurf, or Cline)

Installation

Option 1: npm (Recommended)

npm install -g @bulkpublishing/mcp-server

Option 2: Clone from Source

git clone https://github.com/bulkpublishing/mcp-server.git
cd mcp-server
npm install
npm run build

Authentication

The MCP server authenticates using your Bulk Publishing AI API key. You can find your API key in the web dashboard under Settings → API Access.

Environment Variable

Set your API key as an environment variable:

export BPAI_API_KEY="your-api-key-here"

Inline (Per Client Config)

You can also pass the key directly in the client configuration (see below).

Client Configuration

Claude Desktop

Open your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the BPAI MCP server:

{
  "mcpServers": {
    "bulkpublishing": {
      "command": "npx",
      "args": ["-y", "@bulkpublishing/mcp-server"],
      "env": {
        "BPAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop. You should see the BPAI tools appear in the tool list.

Cursor

Open Cursor Settings → MCP Servers → Add Server:

{
  "name": "bulkpublishing",
  "command": "npx",
  "args": ["-y", "@bulkpublishing/mcp-server"],
  "env": {
    "BPAI_API_KEY": "your-api-key-here"
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "bulkpublishing": {
      "command": "npx",
      "args": ["-y", "@bulkpublishing/mcp-server"],
      "env": {
        "BPAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline (VS Code)

Add to your Cline MCP settings:

{
  "mcpServers": {
    "bulkpublishing": {
      "command": "npx",
      "args": ["-y", "@bulkpublishing/mcp-server"],
      "env": {
        "BPAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Your First Commands

Once connected, try these commands in your AI chat:

1. List Your Projects

Show me all my Bulk Publishing projects

The AI will call list_projects and display your projects with their IDs, names, and descriptions.

2. Generate an Article

Generate an article about "best indoor plants for beginners" using GPT-5.2

The AI will call generate_article with your keyword and model preference, returning a full SEO-optimized article.

3. Check Available Models

What AI models can I use for content generation?

The AI will call list_models and show all available models across your configured providers.

Project Context

The MCP server is project-aware. When you authenticate, your last active project is loaded. All generation, publishing, and export commands operate within the context of your active project.

To switch projects:

Switch to my "Tech Blog" project

This updates the active project for all following commands. Each project has its own:

• WordPress connection settings
• Internal linking configuration
• Knowledge base items
• Custom prompts
• CTA snippets

Multi-Key Configuration

If you've set up multiple API keys for a provider (for parallel generation), the MCP server automatically uses round-robin key rotation. This is configured in the web dashboard under Settings → Multi-Key Config.

Your MCP server inherits these settings automatically. No additional configuration needed.

Subscription Tiers

Troubleshooting

"Authentication failed"

• Verify your BPAI_API_KEY is correct
• Check that your subscription is active at bulkpublishing.ai/settings

"No tools appearing in client"

• Make sure you've restarted the MCP client after updating config
• Check the client's MCP server logs for connection errors
• Verify Node.js 18+ is installed: node --version

"Rate limited by provider"

• You've hit the API provider's own rate limits (not BPAI's)
• Add more API keys via Multi-Key Config in the web dashboard
• Reduce batch size or add delays between requests

"Tool returned empty result"

• Ensure you have at least one AI provider API key configured
• Check that the selected model is available for your provider
• Verify your project has the required settings (e.g., WordPress connection for publishing)

Next Steps

• Content Generation → — Full guide to generating articles
• CSV Import & Export → — Work with local CSV files
• Research Engine → — Run web research before generation