Claude Code

OAuth connections share one ScriptHaul allowance pool across your account’s connected apps. Review the client name and redirect destination host before approving. Reconnect when prompted, no later than 30 days; see connection limits and reconnect timing.

Add the account server from your terminal:

claude mcp add --transport http scripthaul https://api.scripthaul.com/mcp

Run /mcp inside Claude Code, select ScriptHaul, and authenticate in the browser. Finish email-code sign-in and review the mcp consent screen. The grant can create jobs and spend credits, but cannot see or create API keys. Revoke it in Dashboard → Connected apps.

For a shared project configuration, put this in .mcp.json. Each person signs in to their own account:

{
  "mcpServers": {
    "scripthaul": {
      "type": "http",
      "url": "https://api.scripthaul.com/mcp"
    }
  }
}

Use an API key

For an environment that already supplies SCRIPTHAUL_API_KEY, use this configuration instead. Keep the value in the environment, not the project file:

{
  "mcpServers": {
    "scripthaul": {
      "type": "http",
      "url": "https://api.scripthaul.com/mcp",
      "headers": { "Authorization": "Bearer ${SCRIPTHAUL_API_KEY}" }
    }
  }
}

The HTTP command, /mcp authentication, and configuration interpolation were verified 2026-09-05 against Claude Code's MCP documentation.

Try without an account

claude mcp add --transport http scripthaul-taste https://scripthaul.com/mcp

{
  "mcpServers": {
    "scripthaul-taste": {
      "type": "http",
      "url": "https://scripthaul.com/mcp"
    }
  }
}

Ask: “Show the newest videos from channel UC4QobU6STFB0P71PMvOGN5A.” Latest uploads cost zero and use no keyless cold-fetch allowance. Keyless cold transcripts have a limit of 20 per address per UTC day. Switch to the account server for search and durable bulk jobs: one credit per delivered search page or cold transcript; cached transcripts cost zero.

Continue with the agent skill or all tools and costs.