Project Management

The BPAI MCP Server supports multi-project management, allowing you to organize content generation across different domains, clients, or content verticals. Each project has its own isolated WordPress connection, internal linking settings, knowledge base, custom prompts, and CTA snippets.

How Projects Work

Projects are the top-level organizational unit. When you generate content, publish to WordPress, or export articles, the operation runs in the context of your active project. Each project isolates:

  • WordPress Connection — URL, credentials, default category/author
  • Internal Linking Config — Sitemap URLs, max links per post, include/exclude paths
  • Cross-Linking Config — Base URL, link density settings
  • Knowledge Base Items — Brand voice, product facts, guidelines
  • Custom Prompts — System prompt overrides per project
  • CTA Snippets — Marketing blocks inserted into articles
  • Generated Content — All articles are scoped to a project

list_projects

List all projects for the authenticated user.

Parameters

None required.

Example

Show me all my projects

Response

{
  "projects": [
    {
      "id": "proj_001",
      "name": "Tech Blog",
      "description": "Enterprise software reviews and tutorials",
      "color": "#3B82F6",
      "article_count": 147,
      "wordpress_connected": true,
      "created_at": "2026-01-15T10:00:00Z"
    },
    {
      "id": "proj_002",
      "name": "Garden Niche",
      "description": "Indoor plants and gardening guides",
      "color": "#10B981",
      "article_count": 89,
      "wordpress_connected": true,
      "created_at": "2026-01-20T14:30:00Z"
    },
    {
      "id": "proj_003",
      "name": "SaaS Landing Pages",
      "description": "Product comparison and landing page content",
      "color": "#8B5CF6",
      "article_count": 34,
      "wordpress_connected": false,
      "created_at": "2026-02-01T09:15:00Z"
    }
  ],
  "active_project": "proj_001",
  "total_projects": 3,
  "project_limit": 10
}

Note: Projects are created through the web dashboard at bulkpublishing.ai. The MCP server supports listing, switching, and viewing project settings.

Knowledge Base Management

The Knowledge Base stores persistent context that gets injected into every generation prompt for a project. This ensures brand consistency, accurate product mentions, and tone alignment. You can manage the knowledge base entirely from your MCP client.

list_knowledge_base

List all knowledge base items for the active project (or all projects).

Parameter Type Required Default Description
project_id string ❌ Active project Filter by project. Pass "all" to see everything.
full_content boolean ❌ false Show full content instead of 200-char previews

Example:

Show me all my knowledge base items with full content

Response:

{
  "status": "success",
  "total": 3,
  "items": [
    {
      "id": "kb_001",
      "title": "Brand Voice Guidelines",
      "content": "Write in a conversational but authoritative tone...",
      "scope": "🌐 Global",
      "project_id": null
    },
    {
      "id": "kb_002",
      "title": "Product Pricing 2026",
      "content": "TechStack Pro Starter: $29/mo...",
      "scope": "📁 Project",
      "project_id": "proj_001"
    }
  ]
}

add_knowledge_base

Add a new knowledge base item. The content is injected into every AI generation prompt for the project.

Parameter Type Required Default Description
title string ✅ — Descriptive name (e.g. "Brand Voice Guidelines")
content string ✅ — The knowledge content: facts, rules, guidelines
is_global boolean ❌ false If true, applies to ALL projects
project_id string ❌ Active project Which project (ignored if is_global)

Example: Add Brand Voice

Add to my knowledge base:
Title: "Brand Voice Guidelines"
Content: "Write in a conversational but authoritative tone. Use 'you'
frequently. Avoid jargon unless defining it first. Our brand name is
TechStack Pro. Never mention competitors by name. Always recommend our
free trial at techstackpro.com/try"
Make it global (apply to all projects)

Example: Add Product Facts

Add to my Tech Blog knowledge base:
Title: "Product Pricing 2026"
Content: "TechStack Pro Starter: $29/mo (5 users),
TechStack Pro Team: $79/mo (25 users),
TechStack Pro Enterprise: $299/mo (unlimited users).
All plans include 14-day free trial. Annual billing saves 20%."

Response:

{
  "status": "success",
  "message": "Knowledge base item \"Brand Voice Guidelines\" added successfully.",
  "item": {
    "id": "kb_003",
    "title": "Brand Voice Guidelines",
    "scope": "🌐 Global (all projects)"
  },
  "tip": "This item will now be included in all content generations for this project."
}

update_knowledge_base

Update an existing knowledge base item. You can change the title, content, scope, or move it to a different project.

Parameter Type Required Default Description
id string ✅ — KB item ID (from list_knowledge_base)
title string ❌ — New title
content string ❌ — New content
is_global boolean ❌ — Change scope
project_id string ❌ — Move to a different project

Example:

Update knowledge base item kb_002: change the Starter price to $39/mo

delete_knowledge_base

Permanently delete a knowledge base item.

Parameter Type Required Default Description
id string ✅ — KB item ID (from list_knowledge_base)

Example:

Delete knowledge base item kb_002

How KB Context Is Used

During generation, all relevant KB items are prepended to the system prompt:

[System Prompt]
You are a professional content writer...

[Knowledge Base Context]
--- Brand Voice Guidelines ---
Write in a conversational but authoritative tone...

--- Product Pricing 2026 ---
TechStack Pro Starter: $29/mo...

[User Prompt]
Write a 2500-word article about "best project management tools"...

Changes to the knowledge base take effect immediately for the current session. No server restart is needed.

Project Limits by Tier

Tier Max Projects
Free 3
Starter ($29/mo) 10
Pro ($79/mo) Unlimited

Next Steps