MCP Server

What is the MCP server?

The Wahlu MCP (Model Context Protocol) server lets AI coding tools interact with your Wahlu account directly. Use it withClaude Code, Cursor, Windsurf, or any MCP-compatible client to manage content items, publish runs, queues, and more through natural language.

Installation

The MCP server is distributed as an npm package. No global installation is required.

npx @wahlu/mcp-server

Configuration

Claude Code

{
  "mcpServers": {
    "wahlu": {
      "command": "npx",
      "args": ["@wahlu/mcp-server"],
      "env": {
        "WAHLU_API_KEY": "wahlu_live_your_api_key_here"
      }
    }
  }
}

Environment variables

Set WAHLU_API_KEY. The key needs scopes for the operations you call (for example posts:read, posts:write, schedule:write, or notifications:write.

Available tools

Brands

• list_brands - List all brands in your workspace.

Notification Settings

• get_brand_notification_settings - Show the effective email settings for a brand, including whether it inherits account defaults.
• update_brand_notification_settings - Create or update a brand-specific email notification override.
• revert_brand_notification_settings - Stop using custom rules and return a brand to account defaults.

Content Items

• list_content_items - List content items for a brand.
• get_content_item - Get a content item.
• create_content_item - Create a content item.
• update_content_item - Update a content item.
• delete_content_item - Delete a content item.

Publish Runs

• list_publish_runs - List publish runs.
• create_publish_run - Create a publish run.
• update_publish_run - Update a publish run.
• delete_publish_run - Delete a publish run.

Queues

• list_queues - List posting queues.
• add_content_item_to_queue - Add a content item to a queue.

Content

• list_ideas - List saved content ideas.
• create_idea - Save a new content idea.
• list_labels - List labels.

Media

• list_media - List uploaded media files.
• get_upload_url - Create a media record and return signed upload URLs.
• finalise_media_upload - Mark an uploaded media item as ready for processing.

Integrations

• list_integrations - List connected social integrations for a brand.

Publications

• list_publications - List publication history and statuses.

Community (admin-only)

• list_community_posts - List feature requests, bug reports, and improvements.
• get_community_post - Get community post details.
• create_community_post - Create a community post.
• update_community_post - Update a community post.
• delete_community_post - Delete a community post.
• add_admin_note - Add an internal admin note to a community post.
• list_community_comments - List comments for a community post.
• add_community_comment - Add a comment to a community post.
• delete_community_comment - Delete a community comment.

Admin Marketing (admin-only)

• admin_create_brand - Create a prospect brand for outreach.
• admin_onboard_brand - Apply automatic onboarding defaults such as website, category, timezone, and cross-post cadence.
• admin_start_website_scan - Trigger the website scrape and onboarding scan flow.
• admin_get_website_scan - Poll website scan progress.
• admin_get_brand_status - Check onboarding, automation, and generation state.
• admin_start_content_pipeline - Queue automatic content generation for a prospect brand.
• admin_get_marketing_sample_pack - Return outreach-ready samples with captions and downloadable media.

Example usage

> List all my brands and show connected platforms.

> Create a content item for my brand "Acme Co" with the text
  "Excited to announce our new product launch!"

> Create a publish run for tomorrow at 9am GMT.

> Show me all publish runs scheduled for this week.

> Show me the effective email notification settings for my brand "Acme Co",
  then turn off failure emails just for that brand.

> Create a prospect brand for Acme Dental, set it to automatic mode with
  3 cross-posts per week, start a website scan, and tell me when the
  first three outreach samples are ready.