Scribiz MCP API

openapi: 3.2.0
info:
  title: Scribiz MCP API
  version: 1.0.0
  description: 'Operations tagged MCP across 2 of this provider''s published API definitions: openapi.json, scribiz-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- description: 'The one public base for every client: https://scribiz.com/api (Better Auth at /api/auth, remote MCP at https://scribiz.com/mcp). The proxy routes both paths to this API.'
  url: https://scribiz.com/api
tags:
- name: MCP
paths:
  /mcp:
    servers:
    - description: The site root.
      url: https://scribiz.com
    post:
      description: 'Remote MCP, stateless Streamable HTTP. Without credentials (the free tier): captions when the video has them, videos that were already processed, and otherwise a model reads the link (approximate timing, no speaker labels), inside the same 1 free video allowance (up to 2 hours) as the free web tools; never the on-screen layer. When the allowance is used up it serves processed videos. With `Authorization: Bearer sbz_...`: the plan''s limits. Tools: get_transcript, get_video_context, ask_video, search_video, get_job. A browser that opens this URL (GET with `Accept: text/html`) is redirected (303) to the MCP page on the site.'
      operationId: mcp
      requestBody:
        content:
          application/json:
            schema:
              type: object
        description: A JSON-RPC message.
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
            text/event-stream:
              schema:
                type: string
          description: JSON-RPC result, or an event stream with progress.
        '401':
          description: 'Invalid API key (WWW-Authenticate: Bearer error="invalid_token").'
      security:
      - bearer:
        - mcp
      - {}
      summary: Model Context Protocol endpoint
      tags:
      - MCP
components:
  securitySchemes:
    apiKey:
      description: 'An API key (sbz_live_...), as X-API-Key. Keys are made in the dashboard or by `scribiz login`. Each key has one scope, named in an operation''s security requirement. `all`: Everything a key can do: start jobs, upload, ask, cancel, the Gemini proxy and listing keys. Includes read. `mcp`: The remote MCP server at /mcp. Includes read. `read`: Read jobs and their events.'
      in: header
      name: X-API-Key
      type: apiKey
      x-scopes:
        all: 'Everything a key can do: start jobs, upload, ask, cancel, the Gemini proxy and listing keys. Includes read.'
        mcp: The remote MCP server at /mcp. Includes read.
        read: Read jobs and their events.
    bearer:
      description: 'An API key (sbz_live_...) or a session token from the device flow. Each key has one scope, named in an operation''s security requirement. `all`: Everything a key can do: start jobs, upload, ask, cancel, the Gemini proxy and listing keys. Includes read. `mcp`: The remote MCP server at /mcp. Includes read. `read`: Read jobs and their events. A session token has every scope.'
      scheme: bearer
      type: http
      x-scopes:
        all: 'Everything a key can do: start jobs, upload, ask, cancel, the Gemini proxy and listing keys. Includes read.'
        mcp: The remote MCP server at /mcp. Includes read.
        read: Read jobs and their events.
    cookie:
      description: The browser session (same-origin /api/*).
      in: cookie
      name: better-auth.session_token
      type: apiKey
x-refined-from:
- openapi.json
- scribiz-openapi.json