@wahlu/mcp-server

The official Model Context Protocol (MCP) server for Wahlu. Connect AI coding tools like Claude Code, Cursor, and Windsurf to your Wahlu account and manage social media content through natural language.

Quick start

No installation required — just configure your AI tool to run it via npx.

Claude Code

Add to your .mcp.json or .claude/settings.json:

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

Cursor

Open Cursor settings, navigate to MCP Servers, and add a new server:

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

API key

You need a Wahlu API key with the appropriate scopes. Create one in your Wahlu dashboard under Settings > API Keys.

Available tools

Once connected, the MCP server exposes these tools to your AI client:

| Category | Tools | |----------|-------| | Brands | list_brands | | Content Items | list_content_items, get_content_item, create_content_item, update_content_item, delete_content_item | | Publish Runs | list_publish_runs, create_publish_run, update_publish_run, delete_publish_run | | Queues | list_queues, add_content_item_to_queue | | Content | list_ideas, create_idea, list_labels | | Media | list_media, get_upload_url, finalise_media_upload | | Integrations | list_integrations | | Publications | list_publications | | Community | list_community_posts, get_community_post, create_community_post, update_community_post, delete_community_post, add_admin_note, list_community_comments, add_community_comment, delete_community_comment | | Admin Marketing | admin_create_brand, admin_onboard_brand, admin_start_website_scan, admin_get_website_scan, admin_get_brand_status, admin_start_content_pipeline, admin_get_marketing_sample_pack, admin_create_claim_link |

Media upload flow

For media uploads, use this sequence:

1. Call get_upload_url to create a media record and receive signed upload URL(s).
2. Upload file bytes with HTTP PUT to upload_url (and thumbnail URLs if needed).
3. Call finalise_media_upload with the returned media id to set status to ready_for_processing.
4. Use that media ID in create_content_item or update_content_item platform settings.

Example prompts

> List all my brands and show their connected platforms.

> Upload media for my brand and finalise it for processing.

> Create a new content item for my brand "Acme Co" with the content
  "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.

> Create a prospect brand for Acme Dental, configure automatic onboarding
  with 3 cross-posts per week, start the website scan, and fetch the
  first ready sample pack.

> Create a non-expiring claim link for that prospect brand so I can put it in an email.

Documentation

• Full API docs
• MCP server guide
• API recipes

License

MIT