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.
On this page
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.
| Mode | How you connect | Listen and Watch | Local files | Works in |
|---|---|---|---|---|
| Remote, no key | URL only | No Watch. Captions, videos already processed, and a model read of the link | No | Any client that takes a URL. We have tested claude.ai, not ChatGPT |
| Remote, with a key | URL and Authorization: Bearer | Yes, from your minutes | No | Claude Code, Cursor, VS Code, Codex, agent SDKs |
| Local | scribiz mcp started by your client | Yes, 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 key | Yes, from folders you allow | Any client that starts a command |
| Remote, with a sign-in | https://scribiz.com/mcp?oauth=1 and a Scribiz sign-in | Yes, from your minutes | No | Clients 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.
Authorization: Bearer sbz_live_your_key_hereThis 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.
claude mcp add scribiz -- scribiz mcpChoose it when:
- The video is a file on your disk. Add
--allow-files, and--rootfor 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 key | Local | |
|---|---|---|
| Runs on | Scribiz's servers | Your machine |
| Credential | An API key from the dashboard | scribiz login or SCRIBIZ_API_KEY (your account), or scribiz setup or GEMINI_API_KEY (your own Gemini key) |
| Counted in | Your plan's minutes | Your account's minutes with a Scribiz sign-in. With your own key, Google bills it and no Scribiz minutes are used |
| Where the audio goes | Scribiz, then Google | With a sign-in: your machine, then Scribiz, then Google. With your own key: your machine, then Google |
| Fetches links from | Scribiz's servers | Your own connection |
| Local files | No | Yes, from folders you allow |
| Private addresses | Not available | Refused unless you pass --allow-private-network |
watch: true and stored on-screen notes | Yes | Yes |
| Without a credential | A small daily allowance, no picture | The 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.
scribiz mcp --allow-files --root ~/Recordingsscribiz mcp: ready on stdio · files allowed under /Users/you/RecordingsA path outside the allowed folders is refused:
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 want | Use |
|---|---|
| To try it in ten seconds | Remote, no key |
| An agent in Claude Code, Cursor or VS Code that needs to look at the picture | Remote, with a key |
| To use files on your disk | Local |
| To use a video from a site that blocks servers | Local. Or download the file and upload it on the web |
| To avoid Scribiz minutes | Local, with your own Gemini key |
| To use your free account's minutes on your own machine | Local, signed in with scribiz login |
| Your account's minutes and Watch without pasting a key | Remote, with a sign-in |
Checked against the Scribiz build on 2026-10-05.