@offlinecreator/mcp

@offlinecreator/mcp

MCP server + thin CLI for OfflineCreator Studio.

Gives Cursor, Claude Desktop, Claude Code, Hermes, Windsurf, and other MCP clients tools to list models, check credits, generate images/video, and wait for results — using your Studio API key.

Setup

• Sign in to Studio and open Settings (/settings).
• Create an API key and copy the secret once (oc_live_… or oc_test_…).
• Add the server to your MCP client (snippets below).

Environment

Variable	Required	Description
OFFLINECREATOR_API_KEY	Yes	Personal API key from Settings
OFFLINECREATOR_API_BASE	No	API origin. Default https://offlinecreatorstudio.com. Localhost allowed; other hosts need OFFLINECREATOR_ALLOW_INSECURE_API_BASE=true.
OFFLINECREATOR_UPLOAD_ROOT	No	Directory that upload_input file paths must stay inside (default: process cwd).
OFFLINECREATOR_ALLOW_INSECURE_API_BASE	No	Set true only for private/non-prod API hosts.

Security notes

• API keys stay in env / MCP client config — tools never echo them.
• upload_input cannot read arbitrary disk paths: paths must stay under the upload root, use image extensions, pass size limits, and match image magic bytes.
• The client only calls /api/v1/* on a trusted API origin (HTTPS except localhost).
• Generations still use Studio moderation, credit reserve/refund, and ownership checks.

Install by client

Cursor

Add to MCP settings (stdio):

{
  "mcpServers": {
    "offlinecreator": {
      "command": "npx",
      "args": ["-y", "@offlinecreator/mcp"],
      "env": {
        "OFFLINECREATOR_API_KEY": "oc_live_…"
      }
    }
  }
}

Local monorepo (before npm publish):

{
  "mcpServers": {
    "offlinecreator": {
      "command": "node",
      "args": ["C:/Users/YOU/Desktop/mcp_tool/packages/mcp/dist/index.js"],
      "env": {
        "OFFLINECREATOR_API_KEY": "oc_live_…",
        "OFFLINECREATOR_API_BASE": "http://localhost:3000"
      }
    }
  }
}

Claude Desktop

Same JSON under Claude → Settings → Developer → MCP servers.

Claude Code

claude mcp add offlinecreator --env OFFLINECREATOR_API_KEY=oc_live_… -- npx -y @offlinecreator/mcp

Hermes / Windsurf / VS Code

Use the same stdio command / args / env shape as Cursor. Prefer Streamable HTTP remote MCP once Phase 2 is live (https://mcp.offlinecreatorstudio.com/mcp).

Tools

Tool	Purpose
list_models	Launch catalog + credit costs
get_credits	Current balance
list_topups	Credit packs and USD prices
create_topup_checkout	Stripe Checkout URL for a top-up (human pays in browser)
generate	Start generation (wait: true to poll)
upload_input	Attach image for image-to-video, then submit
get_generation	Status / output URL
wait_generation	Poll until done
cancel_generation	Cancel reserved job + refund
list_generations	Recent jobs

Top-ups never charge through the agent. create_topup_checkout returns a Stripe URL; credits land after payment via webhook.

CLI sugar

npx @offlinecreator/mcp models
npx @offlinecreator/mcp balance
npx @offlinecreator/mcp topups
npx @offlinecreator/mcp topup --id topup-1000
npx @offlinecreator/mcp generate --model flux-schnell --prompt "A clean product still" --wait

Development

npm install
npm run mcp:build
OFFLINECREATOR_API_KEY=oc_test_… OFFLINECREATOR_API_BASE=http://localhost:3000 npm run mcp:start

Privacy note

Studio generations run on disclosed cloud providers (not on-device). LocalForge remains the offline product.