Creator OS MCP

MCP server for Creator OS. Connect your Creator OS cloud workspace to MCP-compatible clients and let them work with your content pipeline, brand deals, analytics, AI tools, billing, social integrations, pitch pack, and support data.

The package is published as creator-mcp and runs as a local stdio MCP server. Creator OS also exposes a remote Streamable HTTP MCP endpoint at https://usecreator.app/mcp for clients that support remote MCP connections.

What it includes

• Tools across pipeline, deals, AI, analytics, billing, pitch, social, and support workflows
• 5 read-only resources for profile, pipeline, deals, analytics, and subscription context
• 4 reusable prompts for strategy, negotiations, analytics review, and idea brainstorming
• Token-only setup for end users via CREATOR_OS_TOKEN
• Backward compatibility with Supabase JWTs
• Built for the hosted Creator OS product

Requirements

• Node.js 18+
• An active Creator OS account
• A valid Creator OS MCP token generated from your dashboard

Install

You usually do not install this package globally. Most MCP clients can run it directly with npx.

Recommended local package setup

Use creator-mcp@latest to track the latest published package version. The current published version is 1.2.1.

Claude Code

claude mcp add creator-os --scope user --env CREATOR_OS_TOKEN=YOUR_TOKEN -- npx -y creator-mcp@latest

Claude Desktop

{
  "mcpServers": {
    "creator-os": {
      "command": "npx",
      "args": ["-y", "creator-mcp@latest"],
      "env": {
        "CREATOR_OS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "creator-os": {
      "command": "npx",
      "args": ["-y", "creator-mcp@latest"],
      "env": {
        "CREATOR_OS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Generic local MCP config

If your client supports local stdio servers, use:

{
  "command": "npx",
  "args": ["-y", "creator-mcp@latest"],
  "env": {
    "CREATOR_OS_TOKEN": "YOUR_TOKEN"
  }
}

Remote HTTP endpoint

If your MCP client supports remote Streamable HTTP servers, you can connect directly to:

https://usecreator.app/mcp

Authentication is still required through a bearer token. Send either:

• a Creator OS MCP token (mcp_...)
• a Supabase JWT for backward compatibility

Example generic remote MCP config:

{
  "mcpServers": {
    "creator-os": {
      "url": "https://usecreator.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Discovery metadata for remote clients is published at:

• https://usecreator.app/.well-known/mcp/server-card.json
• https://usecreator.app/.well-known/oauth-protected-resource

Authentication

Set CREATOR_OS_TOKEN to one of the following:

• mcp_... token generated by Creator OS
• Supabase access token JWT for backward compatibility

For commercial cloud usage, end users only need:

CREATOR_OS_TOKEN=YOUR_TOKEN

How to generate a token

1. Log in to Creator OS
2. Open Settings
3. Open the MCP section
4. Generate a new MCP token
5. Copy the mcp_... token into your MCP client config

The recommended setup is always a Creator OS MCP token. Supabase JWT support exists only for backward compatibility.

Tool catalog

Pipeline and content

• list_pipeline_videos
• get_pipeline_video
• update_pipeline_video
• capture_to_pipeline
• list_saved_ideas
• save_idea
• generate_video_idea
• generate_thumbnail
• send_thumbnail_reference

Deals and sponsorships

• list_deals
• get_deal
• create_deal
• update_deal
• export_deals_to_sheets
• generate_coupon_message
• list_coupons
• send_coupon
• submit_brand_proposal

AI

• get_ai_suggestions
• ai_chat
• save_ai_key
• test_ai_key
• delete_ai_key

Analytics

• get_youtube_analytics
• fetch_youtube_data
• fetch_youtube_channel
• get_video_analytics_snapshots

Billing

• check_subscription
• get_credits_balance
• create_checkout
• get_customer_portal
• check_extension_usage

Pitch pack

• get_pitch_config
• update_pitch_config
• list_pitch_deliverables
• get_pitch_views
• generate_pitch_share_token
• get_public_showcase

Social and integrations

• list_integrations
• list_creator_platforms
• sync_instagram
• sync_twitch
• sync_notion
• verify_creator_oauth
• list_instagram_media

Instagram automations

• list_automations
• get_automation
• create_automation
• update_automation
• delete_automation
• toggle_automation
• add_workflow_node
• update_workflow_node

Support

• list_tickets
• get_ticket
• create_ticket
• reply_to_ticket
• list_conversations
• get_conversation_messages

Resources

• creator-profile
• pipeline-status
• deals-overview
• analytics-dashboard
• subscription-status

Prompts

• content-strategy
• deal-negotiation
• analytics-review
• video-idea-brainstorm

Typical use cases

• Plan upcoming YouTube videos from your current pipeline
• Review deal status and sponsorship revenue
• Generate thumbnails and video ideas
• Inspect recent analytics snapshots and identify trends
• Sync Instagram, Twitch, or Notion integrations
• Review billing, credits, and pitch pack performance
• Create and manage support tickets without leaving the MCP client

Security model

• End users only need CREATOR_OS_TOKEN
• MCP API tokens are exchanged server-side for a short-lived Supabase session
• The package supports Supabase JWTs for backward compatibility
• Creator OS is delivered as a hosted cloud product

Local development

cd mcp
npm install
npm run dev

Build and typecheck:

npm run build
npm run typecheck

Run the built server:

npm run start

Notes

• Some tools depend on connected platform integrations in Creator OS
• YouTube analytics tools require the relevant YouTube integration to be connected

License

MIT