Balzac MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "BALZAC_API_KEY=${BALZAC_API_KEY}" balzac -- npx -y balzac-mcp
Required:BALZAC_API_KEY+ 1 optional
README.md

MCP server for the Balzac AI content platform

Balzac MCP Server

MCP server for the Balzac AI content platform -- give AI agents native access to keyword research, article writing, and CMS publishing.

The Balzac MCP server implements the Model Context Protocol so that AI agents like Claude Desktop, OpenClaw, Claude Code, and any MCP-compatible client can manage your entire content pipeline through structured tool calls.


Quick Start

1. Get your API key

Log in to Balzac, go to Settings > API Keys, and generate a key.

2. Configure your MCP client

Add to your MCP configuration (Claude Desktop, OpenClaw, or any MCP-compatible host):

{
  "mcpServers": {
    "balzac": {
      "command": "npx",
      "args": ["-y", "balzac-mcp"],
      "env": {
        "BALZAC_API_KEY": "bz_your_api_key_here"
      }
    }
  }
}

For Claude Desktop, this file lives at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

3. Start using it

Once configured, your AI agent can directly call Balzac tools:

"Research keywords for my site and write an SEO article about the best opportunity"

"Write 3 articles about our top keywords and publish them as drafts to WordPress"

"Rewrite my latest article with a more professional tone"


Environment Variables

Variable Required Description
BALZAC_API_KEY Yes Your Balzac API key (starts with bz_)
BALZAC_API_URL No API base URL (default: https://api.hirebalzac.ai/v1)

Available Tools

Workspaces

Tool Description
list_workspaces List all workspaces
get_workspace Get workspace details
create_workspace Create a workspace from a domain
update_workspace Update workspace settings
delete_workspace Delete a workspace

Keywords

Tool Description
list_keywords List keywords (filter by status)
get_keyword Get keyword details (volume, competition, intent, difficulty, GSC metrics)
create_keyword Add a keyword
enable_keyword Enable a keyword
disable_keyword Disable a keyword
delete_keyword Delete a keyword
generate_keywords Generate new keywords with AI (async)

Suggestions

Tool Description
list_suggestions List content suggestions
get_suggestion Get suggestion details
generate_suggestions Generate 10 new suggestions (1 credit)
accept_suggestion Accept and start writing (5 credits)
reject_suggestion Reject a suggestion

Briefings

Tool Description
list_briefings List briefings
get_briefing Get briefing details
create_briefing Create a briefing and start writing (5 credits)

Articles

Tool Description
list_articles List articles (filter by status, published)
get_article Get article details and content
update_article Update article metadata
delete_article Delete an article
rewrite_article Rewrite article content (3 credits)
regenerate_article_picture Regenerate main picture (1 credit)
publish_article Publish to an integration
schedule_article Schedule future publication
export_article Export as HTML, Markdown, or XML

Competitors

Tool Description
list_competitors List competitor domains
create_competitor Add a competitor
delete_competitor Remove a competitor

Links

Tool Description
list_links List reference links
create_link Add a reference link
delete_link Remove a link

Settings

Tool Description
get_settings Get workspace settings
update_settings Update workspace settings

Tones of Voice

Tool Description
list_tones List available tones
get_tone Get tone details

Integrations

Tool Description
list_integrations List publishing integrations
get_integration Get integration details
create_integration Create an integration (WordPress, Webflow, Wix, GoHighLevel, Webhook)
update_integration Update integration settings
delete_integration Delete an integration
reconnect_integration Re-test integration connection

Credit Costs

Action Credits
Writing an article (accept suggestion or create briefing) 5
Generating 10 new suggestions 1
Rewriti

Tools (8)

list_workspacesList all workspaces
list_keywordsList keywords (filter by status)
generate_keywordsGenerate new keywords with AI (async)
list_suggestionsList content suggestions
create_briefingCreate a briefing and start writing (5 credits)
list_articlesList articles (filter by status, published)
publish_articlePublish to an integration
create_integrationCreate an integration (WordPress, Webflow, Wix, GoHighLevel, Webhook)

Environment Variables

BALZAC_API_KEYrequiredYour Balzac API key (starts with bz_)
BALZAC_API_URLAPI base URL (default: https://api.hirebalzac.ai/v1)

Configuration

claude_desktop_config.json
{"mcpServers": {"balzac": {"command": "npx", "args": ["-y", "balzac-mcp"], "env": {"BALZAC_API_KEY": "bz_your_api_key_here"}}}}

Try it

Research keywords for my site and write an SEO article about the best opportunity
Write 3 articles about our top keywords and publish them as drafts to WordPress
Rewrite my latest article with a more professional tone
Generate 10 new content suggestions for my workspace

Frequently Asked Questions

What are the key features of Balzac MCP Server?

Native AI agent access to keyword research and SEO article generation. Automated CMS publishing to WordPress, Webflow, Wix, and more. Workspace management and competitor tracking capabilities. Content refinement tools including article rewriting and image regeneration.

What can I use Balzac MCP Server for?

Automating the end-to-end content production pipeline from keyword discovery to publishing. Scaling SEO content creation by generating and publishing articles in bulk. Managing multi-platform content distribution across different CMS integrations. Streamlining content updates and rewrites using AI-driven tone adjustments.

How do I install Balzac MCP Server?

Install Balzac MCP Server by running: npx -y balzac-mcp

What MCP clients work with Balzac MCP Server?

Balzac MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Balzac MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare