creator-mcp 1.0.1 → 1.0.2

package/README.md

@@ -0,0 +1,255 @@
+# 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`](https://www.npmjs.com/package/creator-mcp) and runs as a local `stdio` MCP server.
+
+## What it includes
+
+- 54 tools across pipeline, deals, AI, analytics, billing, pitch, social, support, and admin 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`.
+
+### Claude Code
+
+```bash
+claude mcp add creator-os --scope user --env CREATOR_OS_TOKEN=YOUR_TOKEN -- npx -y creator-mcp@latest
+```
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "creator-os": {
+      "command": "npx",
+      "args": ["-y", "creator-mcp@latest"],
+      "env": {
+        "CREATOR_OS_TOKEN": "YOUR_TOKEN"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+```json
+{
+  "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:
+
+```json
+{
+  "command": "npx",
+  "args": ["-y", "creator-mcp@latest"],
+  "env": {
+    "CREATOR_OS_TOKEN": "YOUR_TOKEN"
+  }
+}
+```
+
+## 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:
+
+```bash
+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.
+
+### Internal development only
+
+This package is intended to connect to the hosted Creator OS product. The environment variables below are internal/development overrides and are not part of the normal customer setup:
+
+```bash
+CREATOR_OS_SUPABASE_URL=https://your-project.supabase.co
+CREATOR_OS_SUPABASE_PUBLISHABLE_KEY=your_publishable_key
+```
+
+## 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`
+
+### Support
+
+- `list_tickets`
+- `get_ticket`
+- `create_ticket`
+- `reply_to_ticket`
+- `list_conversations`
+- `get_conversation_messages`
+
+### Admin
+
+- `admin_get_overview`
+- `admin_stealth_clean`
+- `admin_virus_scan`
+
+## 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
+- Internal override variables exist for development only and should not be part of customer-facing setup
+
+## Local development
+
+```bash
+cd mcp
+npm install
+npm run dev
+```
+
+Build and typecheck:
+
+```bash
+npm run build
+npm run typecheck
+```
+
+Run the built server:
+
+```bash
+npm run start
+```
+
+## Notes
+
+- Some tools depend on connected platform integrations in Creator OS
+- Admin tools require an admin-capable token
+- YouTube analytics tools require the relevant YouTube integration to be connected
+
+## License
+
+MIT

package/dist/index.js

@@ -23,7 +23,7 @@ import { registerResources } from "./resources.js";
 import { registerPrompts } from "./prompts.js";
 const server = new McpServer({
     name: "creator-os-mcp",
-    version: "1.0.0",
+    version: "1.0.2",
 }, {
     instructions: [
         "Creator OS MCP Server — a comprehensive toolkit for YouTube creators.",
@@ -39,9 +39,10 @@ const server = new McpServer({
         "",
         "Environment variables needed:",
         "  CREATOR_OS_TOKEN                    — MCP API token or Supabase JWT (required)",
-        "Optional overrides for self-hosted/dev environments:",
-        "  CREATOR_OS_SUPABASE_URL            — Override the default Supabase project URL",
-        "  CREATOR_OS_SUPABASE_PUBLISHABLE_KEY — Override the default Supabase publishable key",
+        "",
+        "Creator OS is a hosted cloud product.",
+        "Use an MCP token generated in Creator OS for normal customer setup.",
+        "Supabase override variables are internal development hooks and are not required by end users.",
     ].join("\n"),
     capabilities: {
         logging: {},

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,uEAAuE;QACvE,sEAAsE;QACtE,yEAAyE;QACzE,6EAA6E;QAC7E,uBAAuB;QACvB,EAAE;QACF,iEAAiE;QACjE,2BAA2B;QAC3B,qFAAqF;QACrF,sEAAsE;QACtE,EAAE;QACF,+BAA+B;QAC/B,kFAAkF;QAClF,sDAAsD;QACtD,kFAAkF;QAClF,uFAAuF;KACxF,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,YAAY,EAAE;QACZ,OAAO,EAAE,EAAE;KACZ;CACF,CACF,CAAC;AAEF,sEAAsE;AACtE,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;AACxB,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;AAExB,sEAAsE;AACtE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,sEAAsE;AACtE,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;IAC1B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,uEAAuE;QACvE,sEAAsE;QACtE,yEAAyE;QACzE,6EAA6E;QAC7E,uBAAuB;QACvB,EAAE;QACF,iEAAiE;QACjE,2BAA2B;QAC3B,qFAAqF;QACrF,sEAAsE;QACtE,EAAE;QACF,+BAA+B;QAC/B,kFAAkF;QAClF,EAAE;QACF,uCAAuC;QACvC,qEAAqE;QACrE,+FAA+F;KAChG,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,YAAY,EAAE;QACZ,OAAO,EAAE,EAAE;KACZ;CACF,CACF,CAAC;AAEF,sEAAsE;AACtE,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;AACxB,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;AAExB,sEAAsE;AACtE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,sEAAsE;AACtE,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;IAC1B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "creator-mcp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP server for Creator OS — access your pipeline, deals, analytics, AI tools, and more via any MCP-compatible client",
   "type": "module",
   "license": "MIT",