Dashboardmcporter
MCP Setup
Use the same `/api/mcp` endpoint for MCP-native clients and for OpenClaw through `mcporter`.

Supported auth modes

  • OAuth/OIDC bearer tokens for hosted MCP clients.
  • MCP-scoped API keys in the x-api-key header for bridge clients and private automations.
  • Create API keys from the profile menu under MCP Access.
  • Don't paste MCP API keys into shared or public chats. Rotate keys immediately if exposed.

Use the www endpoint directly. Some MCP/HTTP clients do not preserve custom headers (like x-api-key) across redirects to a different host, which can cause 401s. Always use https://www.brainrotshorts.com/api/mcp.

Available tools

The public MCP endpoint currently exposes 32 tools. Public tool IDs now use underscores so strict MCP clients can validate them.

Project, script, and render tools

  • project_get
  • project_list
  • character_list
  • background_list
  • caption_style_list
  • render_status
  • render_latest_url
  • project_create
  • project_update
  • project_scene_update
  • script_ideate
  • script_generate
  • project_apply_script
  • render_start
  • project_delete

Overlay tools

  • overlay_get
  • overlay_sticker_list
  • overlay_font_list
  • overlay_image_list
  • overlay_timeline
  • overlay_image_upload
  • overlay_add
  • overlay_update
  • overlay_remove
  • overlay_render

Reddit video tools

  • reddit_post_fetch
  • reddit_script_generate
  • reddit_post_repurpose
  • reddit_project_create
  • reddit_project_update
  • reddit_video_create_from_prompt
  • reddit_video_create_from_url

Direct MCP client example

If you self-host on another domain, replace https://www.brainrotshorts.com with your own app origin.

{
  "mcpServers": {
    "brainrotshorts": {
      "url": "https://www.brainrotshorts.com/api/mcp",
      "headers": {
        "x-api-key": "brs_your_mcp_api_key"
      }
    }
  }
}

OpenClaw via mcporter

OpenClaw can use mcporter as the bridge to the remote MCP server. Point mcporter at /api/mcp and pass the API key in MCPORTER_HEADER_X_API_KEY.

{
  "mcpServers": {
    "brainrotshorts": {
      "command": "mcporter",
      "args": [
        "--server",
        "https://www.brainrotshorts.com/api/mcp"
      ],
      "env": {
        "MCPORTER_HEADER_X_API_KEY": "brs_your_mcp_api_key"
      }
    }
  }
}

Approval behavior

render_start does not queue work unless approved=true is passed. This keeps external MCP clients aligned with the in-app approval requirement.

Reddit workflow tools follow the same rule: they create the project immediately, but only queue a render when approved=true is included.

Troubleshooting

401 after redirect / origin mismatch

  • Cause: Calling the non-www endpoint (https://brainrotshorts.com/api/mcp) triggers a redirect to the www host. Some clients drop the x-api-key header on cross-host redirects.
  • Fix: Use https://www.brainrotshorts.com/api/mcp directly (no redirect). If your client has a setting like “preserve headers on redirect”, enable it.