Sleeper Hit Studio MCP

Sleeper Hit Studio is a story-creation and production workspace. Its authenticated MCP connector can start from a premise, notes, research, source material, or an existing screenplay and carry the work through development, writing, performance, coverage, rendering, packaging, and publishing.

Machine-readable capability manifest (no account or credential needed to read it):

https://sleeperhit.studio/capabilities.json

It covers both MCP connectors, the Story API, and the CLI, and states the auth requirement and required scopes for every capability.

No Sleeper Hit account yet?

Account access is waitlist-gated — there is no self-serve signup, and an agent cannot create an account for its user. Everything creative (projects, Series Bibles, screenplays, table reads, pitch decks, publishing) needs an account; public discovery and every documentation surface do not. Hand the human the link that matches them, then stop:

Business and brand storytelling — https://sleeperhit.studio/waitlist?intent=business
Independent creator — https://sleeperhit.studio/waitlist?intent=creator
Screenwriter — https://sleeperhit.studio/waitlist?intent=writer

Preferred: remote OAuth

The preferred modern connector is the OAuth-protected Streamable HTTP server:

https://sleeperhit.studio/mcp

Codex

codex mcp add sleeperhit --url https://sleeperhit.studio/mcp
codex mcp login sleeperhit

For stage testing:

codex mcp add sleeperhit --url https://stage.sleeperhit.studio/mcp
codex mcp login sleeperhit

codex mcp login opens or directs the user to browser OAuth. Finish authorization there, return to Codex, and reopen or refresh the active task if the authenticated Sleeper Hit catalog does not appear immediately. Inspect the registration with:

codex mcp get sleeperhit --json
codex mcp list --json

After connection, call whoami, get_agent_guidance, and get_credits before committing credits. get_agent_guidance returns the live backend guidance plus a structured workflow router for the full catalog.

Claude.ai, Cowork, and other remote clients

Add https://sleeperhit.studio/mcp as a custom remote MCP server. The client should discover Sleeper Hit's OAuth server from the protected-resource challenge, open browser authorization, and retain the resulting token.

The two remote surfaces

Endpoint	Role	Authentication
`https://sleeperhit.studio/mcp`	Full private creation and production	OAuth
`https://sleeperhit.studio/api/mcp`	Public creator/story discovery only	None; read-only

Do not point a creation workflow at /api/mcp. It intentionally contains no private-account or generation tools.

Workflow map

The authenticated tool catalog is grouped so agents can decide what to call next:

Orientation and account — whoami → get_agent_guidance
Credits and usage — get_credits
Projects and source material — list_projects / create_project → sources
Series Bible and development — Bible, cast canon, and foundational coverage
Planning and screenwriting — plan → approve → job → screenplay pages
Visual development and storyboarding — pitch-deck and trailer board review
Table reads and audio — cast, voices, performance, music, SFX, durable audio
Video rendering — theater motion and durable video
Coverage and revision — read coverage, revise, and re-review
Apps, seasons, and automation — controlled repeatable and multi-installment flows
Publishing and analytics — destinations, releases, feeds, and analytics

The server attaches workflow metadata and MCP annotations to every authenticated tool. These are navigation hints, not authorization; OAuth scopes and Story API handlers remain the enforcement boundary.

These are live post-creation controls over the same project and artifact lifecycle, not a separate demo catalog.

Workflow gates

Begin with identity, live agent guidance, and credits.
Attach user-provided source material before development.
For screenplay and series work, strongly encourage a complete Series Bible and review its development/visual readiness before generation.
Show the exact plan and quote before creating a credit-reserving job.
Poll async work with the matching get_* or list_* tool named in guidance.
Read existing screenplay coverage before requesting another report, then apply a focused revision pass before finalization or pitch packaging.
Distinguish live previews from durable finalized MP3/MP4 artifacts.
Never publish, schedule, share, cancel, delete, or make another externally visible change without explicit user intent.

Alternative: local stdio / API key

The package in packages/mcp-server remains the local stdio and customer API-key integration. It is a thin wrapper over the Story API and uses the same scopes, rate limits, idempotency, and audit path as the web and CLI surfaces.

The package is not currently published to npm. Build it from this repository:

pnpm --filter @sleeperhit/mcp-server build
SLEEPERHIT_API_KEY=sh_... node packages/mcp-server/dist/index.js

Example local MCP configuration:

{
  "mcpServers": {
    "sleeperhit": {
      "command": "node",
      "args": ["/absolute/path/to/sleeperhit-studio/packages/mcp-server/dist/index.js"],
      "env": {
        "SLEEPERHIT_API_KEY": "sh_...",
        "SLEEPERHIT_BASE_URL": "https://sleeperhit.studio"
      }
    }
  }
}

Requirements:

Node.js 20 or later.
A scoped customer API key from https://sleeperhit.studio/dashboard/api.
SLEEPERHIT_BASE_URL only when targeting stage or local development.

The binary reserves stdout for MCP protocol traffic and writes operational logs to stderr.

Source of truth

Live availability: GET /api/v1/capabilities
Backend guidance and workflow navigation: GET /api/v1/agent-guidance
Full machine-readable tool map: https://docs.sleeperhit.studio/docs/mcp-tools.json
Client setup guide: https://docs.sleeperhit.studio/mcp
Shared onboarding/workflow manifest: packages/shared/src/mcp-onboarding.ts