Bulk Publishing AI — MCP Server

A Model Context Protocol (MCP) server that gives any MCP-compatible client (Claude, Cursor, Windsurf, etc.) full access to BPAI's content generation, research, WordPress publishing, and SEO indexing tools.

What It Does

Generate SEO-optimized articles with built-in web research, humanization, and internal linking from any MCP client. No manual workflow chaining needed.

You: "Generate 5 articles about email marketing using claude-opus-4.5 with humanize enabled"

What happens automatically:
  1. 🔬 Research each keyword via Perplexity Sonar Pro
  2. 📝 Generate each article with research data + knowledge base + internal links
  3. ✨ Humanize each article (20-rule anti-AI detection pass)
  4. 💾 Save all articles to your library

4 Workflow Modes

| Mode | Flags | Description | |---|---|---| | Research + Generate | default | Web research runs first, then writes using real data | | Research + Generate + Humanize | humanize: true | Full pipeline with anti-AI rewrite | | Generate Solo | auto_research: false | Skip research, write from AI knowledge only | | Generate + Humanize | auto_research: false, humanize: true | No research, but humanize output |

Quick Start

Option 1: npx (no install)

Add to your MCP config:

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

Option 2: Local install

npm install -g @bulkpublishing/mcp-server

Then add to your MCP config:

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

Option 3: From source

cd mcp-server && npm install && npm run build

{
  "mcpServers": {
    "bulkpublishing": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "BPAI_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools (26 Total)

Content Generation

| Tool | Description | |------|-------------| | generate_article | Generate a single article with auto-research, linking, and humanization | | generate_batch | Generate multiple articles with per-keyword research and cross-linking | | list_models | List all 50+ available AI models across 7 providers | | list_articles | Browse and search your article library | | get_article | Retrieve full content of a stored article |

Research

| Tool | Description | |------|-------------| | research_topic | Standalone web research with citations (Perplexity, Gemini, OpenAI, Grok, DeepSeek) |

SEO

| Tool | Description | |------|-------------| | generate_seo_metadata | Generate title, slug, and meta description | | humanize_content | Standalone anti-AI detection rewrite pass |

WordPress Publishing

| Tool | Description | |------|-------------| | test_wp_connection | Verify WordPress credentials and fetch site info | | publish_to_wordpress | Publish a single article via REST API | | publish_batch | Publish multiple articles with rate limiting | | list_wp_categories | List WordPress categories |

Indexing & SEO

| Tool | Description | |------|-------------| | broadcast_urls | Submit URLs to IndexNow + ping Google/Bing/WebSub | | indexnow_submit | Direct IndexNow API submission | | fetch_sitemap | Parse sitemap.xml and return URL list |

CSV Import / Export

| Tool | Description | |------|-------------| | import_csv | Read CSV, auto-detect columns, preview rows | | export_csv | Export articles to CSV | | export_markdown | Export as .md files with YAML frontmatter | | export_json | Export as structured JSON | | export_bulk | Multi-format export with filtering |

Projects & Knowledge Base

| Tool | Description | |------|-------------| | list_projects | List all projects | | switch_project | Switch active project | | get_project_settings | View project settings | | list_knowledge_base | View KB items | | add_knowledge_base | Add persistent context for generation | | update_knowledge_base | Update KB items | | delete_knowledge_base | Remove KB items |

Supported Providers & Models

| Provider | Models | |----------|--------| | OpenAI | GPT-5.2, GPT-5.1, GPT-5 Mini, GPT-4.1, O4 Mini | | Claude | Opus 4.5, Sonnet 4.5, 3.7 Sonnet, 3.5 Sonnet/Haiku | | Gemini | 3 Pro, 3 Flash, 2.5 Pro/Flash, 2.0 Flash | | Grok | 4 Flagship, 4.1 Fast, 3, 3 Mini | | DeepSeek | Reasoner (V3.2), Chat | | Kimi | K2.5 Thinking, K2.5, K2 | | Perplexity | Sonar Pro, Sonar Reasoning Pro, Deep Research, Sonar |

API Keys

All API keys are managed through your BPAI account at bulkpublishing.ai. The only env variable you need is BPAI_API_KEY. Your provider keys (OpenAI, Claude, Gemini, etc.) are loaded from your account settings automatically.

Documentation

Full documentation: docs/mcp/

1. Overview
2. Getting Started
3. Content Generation
4. CSV Import & Export
5. Research Engine
6. WordPress Publishing
7. Indexing & SEO
8. Project Management
9. Models & Providers
10. Advanced Usage

License

MIT