Skip to content
Scribiz
Get transcript

MCP

MCP connection modes

Remote without a key, remote with an API key, the local server with your account or Gemini key, and the Scribiz account sign-in (OAuth). What each can do and which to pick.

View Markdown

The server can be reached four ways. https://scribiz.com/mcp works right away with no sign-in. Remote with a key needs an API key from your account. Remote with a sign-in (OAuth) connects your Scribiz account from the client, with no key to paste. Local runs on your machine from the command-line tool, with your Scribiz account or your own Gemini key.

ModeHow you connectListen and WatchLocal filesWorks in
Remote, no keyURL onlyNo Watch. Captions, videos already processed, and a model read of the linkNoAny client that takes a URL. We have tested claude.ai, not ChatGPT
Remote, with a keyURL and Authorization: BearerYes, from your minutesNoClaude Code, Cursor, VS Code, Codex, agent SDKs
Localscribiz mcp started by your clientYes, with your Scribiz account or your own Gemini key. It takes watch: true and serves stored on-screen notes, like the remote server with a keyYes, from folders you allowAny client that starts a command
Remote, with a sign-inhttps://scribiz.com/mcp?oauth=1 and a Scribiz sign-inYes, from your minutesNoClients that support MCP OAuth

Remote, no key

Paste https://scribiz.com/mcp into a client and it works. There is nothing to sign up for.

What you get:

  • Captions, when our server can read them. Up to 30 caption lookups a day, counted per connection.
  • Results Scribiz has already stored for a video, at no cost, however they were first read. The one exception is a summary Scribiz has not written for it yet, which uses a tenth of the video's length.
  • When there are no captions our server can read, a model reads the video from its link. Its times are approximate (close on a short video, up to a minute off on a long one), it has no speaker labels, and the result says so.

That reading shares the same 1 free video allowance (up to 2 hours) as the free web tool. A video known to be longer than 2 hours is refused before anything is used.

What you do not get is Watch. The server never looks at the picture, so there are no on-screen notes.

Everyone who connects without a key also shares one daily spend ceiling. It is separate from the website's free tools: neither can use up the other's. When your free video is used up, videos already processed still work, and signing in for a free account adds 30 minutes a month. See Limits and cost.

Remote, with a key

Send your API key as a bearer token, or in an X-API-Key header. Keys are made in the dashboard, after you sign in with an email link. Give a key the mcp scope if it will only be used for this.

Text
Authorization: Bearer sbz_live_your_key_here

This unlocks Listen, Watch and Both, counted in your plan's minutes. A key with the mcp or all scope works. A bad key is 401, and a key with only the read scope is 403. A session token from the website is not accepted. The same key works for the API, and calls from both share one balance.

Clients that accept a custom header work with a key: Claude Code, Cursor, VS Code, Codex and the agent SDKs. claude.ai takes no custom header: use the keyless URL, or the sign-in below for your account's minutes and Watch.

Local

scribiz mcp runs the server on your machine over standard input and output. Your client starts it as a command. It comes with the command-line tool: run npm install -g scribiz, then scribiz login to use a free Scribiz account, or scribiz setup to save your own Gemini key. It needs Node.js 24 or newer, ffmpeg and yt-dlp (see Install the CLI), and only macOS has been tested. The watch argument and stored on-screen notes need scribiz 0.1.1 or newer.

Terminal
claude mcp add scribiz -- scribiz mcp

Choose it when:

  • The video is a file on your disk. Add --allow-files, and --root for each folder the agent may read. Without --root, the current folder is the one allowed folder, except /, your home folder or a folder above it: a client that starts the server in one of those must pass --root.
  • The site blocks servers (TikTok, Instagram, and others). The local server fetches from your connection.
  • You want to use your own Gemini key. Audio goes from your machine to Google, and no Scribiz minutes are used.
  • You want your free account's minutes (30 a month) in an agent on your machine, with no API key to make. Audio goes from your machine to Scribiz, which has it read by its speech model (ElevenLabs through OpenRouter) or by Google.

It reads the same credential as the CLI, and the first match wins: SCRIBIZ_API_KEY, then GEMINI_API_KEY, then what scribiz login or scribiz setup saved. One credential is saved at a time. The credential is read on every tool call, so a sign-in you save after the client started is picked up. If GEMINI_API_KEY is set in the environment your client starts the server with, it wins over a saved sign-in. See Authentication.

With an account and no minutes left, a tool call returns the error QUOTA and says when your minutes come back. Your own Gemini key is the other way.

Watch and on-screen notes

The local server takes the watch argument on get_video_context, the same as the remote server with a key. watch: true reads the picture too (slides, code, text on screen), even when the video is mostly speech. On-screen notes that are already stored come with the result at no cost. Both are described on Tools. What a read costs is paid by your credential: your account's minutes with a Scribiz sign-in, or Google's bill with your own Gemini key.

What is different from the remote server

Remote, with a keyLocal
Runs onScribiz's serversYour machine
CredentialAn API key from the dashboardscribiz login or SCRIBIZ_API_KEY (your account), or scribiz setup or GEMINI_API_KEY (your own Gemini key)
Counted inYour plan's minutesYour account's minutes with a Scribiz sign-in. With your own key, Google bills it and no Scribiz minutes are used
Where the audio goesScribiz, then GoogleWith a sign-in: your machine, then Scribiz, then Google. With your own key: your machine, then Google
Fetches links fromScribiz's serversYour own connection
Local filesNoYes, from folders you allow
Private addressesNot availableRefused unless you pass --allow-private-network
watch: true and stored on-screen notesYesYes
Without a credentialA small daily allowance, no pictureThe server starts and says on standard error that tool calls will fail until there is a credential. Each call answers AUTH until you sign in or save a key

The remote server with a key is the one to use when you do not want to install anything. The local server is the one to use for files, for sites that block servers, and to run with your own Gemini key.

The model that calls the server may have read a page that told it to fetch a link. So the local server refuses links to your own machine and to private networks (localhost, 192.168.x.x, *.local, a cloud metadata address), and pages that only the generic reader of yt-dlp handles. Direct media links, YouTube, Instagram, TikTok, Vimeo and X work. --allow-private-network lifts both rules.

Terminal
scribiz mcp --allow-files --root ~/Recordings
Standard error, once the server is ready
scribiz mcp: ready on stdio · files allowed under /Users/you/Recordings

A path outside the allowed folders is refused:

Text
Scribiz error INPUT_UNSUPPORTED (not retryable): That file is outside the folders this server may readHint: Allowed folders: /Users/you/Recordings. Move the file there or start the server with another --root.

Remote, with a sign-in

Add https://scribiz.com/mcp?oauth=1 to a client that supports MCP OAuth. The client opens a Scribiz sign-in and consent page. Approving it makes an mcp key for that client, listed under API keys in your dashboard, where you can revoke it. Calls then count your plan's minutes and get Listen, Watch and stored on-screen notes, the same as a key.

The plain https://scribiz.com/mcp stays keyless: it never asks you to sign in.

Which one

You wantUse
To try it in ten secondsRemote, no key
An agent in Claude Code, Cursor or VS Code that needs to look at the pictureRemote, with a key
To use files on your diskLocal
To use a video from a site that blocks serversLocal. Or download the file and upload it on the web
To avoid Scribiz minutesLocal, with your own Gemini key
To use your free account's minutes on your own machineLocal, signed in with scribiz login
Your account's minutes and Watch without pasting a keyRemote, with a sign-in

Checked against the Scribiz build on 2026-10-05.

Loading the index