All the scripts in your CutKit library, reachable from any agent. Write a script in Claude, ChatGPT or your own code, and it's in the teleprompter the next time you open the app. Edit it on the phone, and your agent sees the change.
Quick start
Turn on agent access
Open CutKit on your iPhone, go to Settings, Agent access, and turn it on. It's off until you do, and until then nothing leaves your phone.
Connect your agent
In ChatGPT or Claude, add this address as a connector, then sign in.
https://getcutkit.com/mcpAnything else takes your API key. Get your key.
Ask for a script
Your agent writes it, and it's in the teleprompter the next time you open the app.
Pick a way in
There are 3 ways in, and they do the same things. The REST API and the CLI take an API key. The MCP server takes a sign in, so ChatGPT and Claude connect without one.
- MCP server ChatGPT, Claude, Cursor, Claude Code and any MCP client. Sign in
- CLI A Node script for your terminal, your scripts and local agents. API key
- REST API JSON over HTTPS, from your own code. API key
To install every skill at once, paste getcutkit.com/skills.md to your agent. It picks the skills that fit and installs them.
Your agent can also read the CutKit Agent Skill.
It covers the tools, the limits and how to write a script that reads well on the
teleprompter. In Claude Code, save it as ~/.claude/skills/cutkit/SKILL.md.
To write scripts that pass the script check, add the CutKit script check skill. It lists
the 9 checks, the hook shapes and the length per platform, and tells your agent to call check_script before it saves. In Claude Code, save it as ~/.claude/skills/cutkit-script-check/SKILL.md.
MCP server
Add CutKit as a connector with this address, then sign in. There's no key to copy.
https://getcutkit.com/mcpClaude (claude.ai and the desktop app)
- Open CutKit in Claude's connector directory.
- Press Connect.
- Sign in to CutKit and press Allow.
ChatGPT
- Open CutKit in ChatGPT's plugins.
- Press Install plugin.
- Sign in to CutKit and press Allow.
Menu names move around, so if one has changed, look for where custom connectors or apps live. Sign in with the same CutKit account you use on your iPhone, and your scripts are already there. On the web, the Agents page lists every connected app and disconnects any of them. Rotating your key disconnects all of them.
Other MCP clients
For a client that reads an mcpServers file (Cursor, Windsurf), the address is
enough, and it opens the sign in itself. A key still works too. In Claude Code:
claude mcp add --transport http cutkit https://getcutkit.com/mcp \
--header "Authorization: Bearer ck_your_key"Or in a config file:
{
"mcpServers": {
"cutkit": {
"type": "http",
"url": "https://getcutkit.com/mcp",
"headers": { "Authorization": "Bearer ck_your_key" }
}
}
}MCP tools
All clients get the same 18 tools:
list_templates- List the templates for a hook, with their families. Each template pairs an opening line with the re-hook that gives a new reason to stay halfway. Each has an id for get_template and start_from_template. The check's templateIds point here too.
get_template- Read one template by id: its opening line and re-hook, why it works, 2 examples and the way it goes wrong.
start_from_template- Add a script built on a template, the same draft the app makes: the opening line and its re-hook in place and a [bracket] for every beat to write.
start_story- Add a script built on the story beats: stakes, the big question, the head fake and a re-hook, each a [bracket] to fill.
plan_month- Seed 30 draft scripts, one a day, rotating through 1 to 6 topics and 5 templates from different families. Each is titled Day N and labelled with its topic. Needs CutKit Pro or a trial on the account that owns the library.
check_script- Check a script's craft: a grade from A+ to F, the score out of 100 behind it, and 20 checks, each failing one with a fix and templates that fit. A boring topic fails topic_pull whatever the wording. With a profile set, audience_fit fails when the script talks to somebody other than the profile's audience. It doesn't predict views. Read only, 100 a day, and the answer says how many are left. Identical text checked again within 24 hours is free. Unsure yes-or-no items were a guess and aren't scored. Needs CutKit Pro or a trial on the signed-in account.
lint_script- Run only the checks that need no model: first line length, a greeting or stalling opener, hedges, a flat stretch and AI-sounding text. No quota, no network call to a model, instant.
list_scripts- List every script in the person's CutKit library, pinned first then newest, with ids, titles and word counts. Bodies are left out.
get_script- Read one script, title and body, by id or by title.
create_script- Add a script to the person's CutKit library. It appears in the iPhone app's teleprompter the next time the app opens. Put only the words to read out loud in body. With no title, the first line becomes the title.
update_script- Change a script's title, body, pin, labels or status. Only the fields sent change.
delete_script- Delete a script. It disappears from the phone on its next sync.
list_labels- Every label in use and how many scripts carry it.
rename_label- Rename a label on every script that has it. Renaming onto an existing label merges the two.
delete_label- Take a label off every script that has it. The scripts stay.
set_label_color- Set a label's color, the same on the phone and the web. One of red, orange, amber, green, teal, sky, blue, violet, pink, or null for none.
get_profile- Read who the creator is (about), who their videos are for (audience) and what they sell (offer). Scripts are graded against this audience.
set_profile- Set any of about, audience and offer, up to 1200 characters each. A field left out keeps its value, and "" clears it. Once audience is set, the script check adds an audience_fit check that fails when a script talks to somebody else.
The server speaks the 2026-07-28 MCP spec and the 4 before it, over Streamable HTTP.
It's stateless, so there's no session to keep alive. Calls all need a sign in, and
an unsigned one gets a 401 that points to /.well-known/oauth-protected-resource/mcp.
For builders
OAuth 2.1 with PKCE (S256), public clients only. Clients that publish a Client ID Metadata
Document use its URL as the client_id. Others register at https://getcutkit.com/oauth/register. Metadata is at /.well-known/oauth-authorization-server, the one scope is scripts,
and access tokens last an hour with rotating refresh tokens.
Your API key
The CLI and the REST API take a key. Here's where it lives.
- Open CutKit on your iPhone and tap the key button at the top of the Scripts list.
- Turn on Agent access. The app makes your library and shows the key.
- Tap Copy key. It starts with
ck_.
The key syncs to your other Apple devices through iCloud Keychain, so every iPhone signed in to your Apple Account shares one library. Rotate key gives you a new one and stops the old one at once. Turning agent access off deletes the library and every script in it from our server. The scripts on your phone stay.
Give it to your agent
Paste this to any agent that can make HTTP requests or use MCP:
My CutKit API key is ck_your_key. Use the CutKit API
(https://getcutkit.com/docs/api) to manage my teleprompter scripts.Treat the key like a password. Anybody holding it can read and change your scripts, and nothing else: it opens no account, no recordings and no purchases.
CLI
cutkit-scripts is a Node script with no extra installs that runs
from a CutKit checkout on Node 24. Run it with node ios/cli/cutkit-scripts.mjs,
or symlink it onto PATH as cutkit-scripts. It reads the key from CUTKIT_API_KEY and the base URL from CUTKIT_API_URL (it defaults to https://getcutkit.com).
export CUTKIT_API_KEY=ck_your_key
# optional: export CUTKIT_API_URL=https://getcutkit.com
node ios/cli/cutkit-scripts.mjs list
# or symlink it onto PATH as cutkit-scripts, then:
cutkit-scripts list
cutkit-scripts whoami
cutkit-scripts push intro.md --title "Launch video intro"
echo "New words" | cutkit-scripts push --title "Launch video intro"
cutkit-scripts push intro.md --title "New title" --replace "Launch video intro"
cutkit-scripts push intro.md --pin --title "Launch video intro"
cutkit-scripts show "Launch video intro"
cutkit-scripts rm "Launch video intro"
cutkit-scripts templates --family question # no key needed
cutkit-scripts template belief-then-break
cutkit-scripts start belief-then-break --title "Launch video intro"
cutkit-scripts check "Launch video intro" # grade and score first, then the fixes
cutkit-scripts check --file intro.md --json
cutkit-scripts list --json # one JSON value on stdout, for scripts and agents
cutkit-scripts mcp # the remote server's tools over local stdioCommands are list, show, push, rm, whoami, mcp and help. Pushing the same title
twice updates the script, never adds a copy. Use --replace to retitle
one, and --pin to keep it at the top. whoami shows which
library the key opens.
JSON and errors
All commands take --json. A refusal is {"error": {...}} with exit code 1. show, rm and push --replace take an id or a title.
REST API
Base URL https://getcutkit.com. JSON in and out, the key in an Authorization: Bearer header, CORS open to every origin. The full spec is openapi.json (OpenAPI 3.1).
GET/api/v1/templatesEvery template, each an opening line and its re-hook, with its family. Filter with ?family=. No key needed.GET/api/v1/templates/{id}One template with its family. No key needed.POST/api/v1/templates/{id}/scriptsSave a new script from a template's scaffold. Send a title, pin or labels.POST/api/v1/checkCheck a script by body or id: grade, score, failing checks and their fixes. It doesn't predict views.POST/app/api/checkCheck the signed-in web editor's body.POST/api/v1/rewriteRewrite a script by body or id so its failing checks pass. Saves nothing. 50 a day.POST/app/api/rewriteRewrite the signed-in web editor's body.GET/api/v1/scriptsLive scripts, pinned first then newest. With ?since=, every change since then.POST/api/v1/scriptsCreate a script. Send an id to make a retry safe.GET/api/v1/scripts/{id}Read one script.PUT/api/v1/scripts/{id}Create or replace the script with this id.PATCH/api/v1/scripts/{id}Change only the fields you send.DELETE/api/v1/scripts/{id}Delete a script. Leaves a tombstone for syncing.GET/api/v1/labelsEvery label in use, how many scripts carry it and its color.PATCH/api/v1/labels/{name}Rename a label on every script. Merges onto an existing label.DELETE/api/v1/labels/{name}Take a label off every script.PUT/api/v1/labels/{name}/colorColor a label, or send null to clear it. The phone shows the same color.GET/api/v1/meCheck a key: its library and how many scripts it holds.DELETE/api/v1/meDelete the library, every script and the key.POST/api/v1/keys/rotateA new key for the same scripts. The old one stops at once.POST/api/v1/keysMake an empty library and its key. The iPhone app's call, signed with App Attest.
Examples
Start from a template. This saves the template's scaffold as a new script.
curl -X POST https://getcutkit.com/api/v1/templates/belief-then-break/scripts \
-H "Authorization: Bearer $CUTKIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title": "Launch video intro"}'Check a script. Send body or a saved id. You get
back a grade from A+ to F, the score out of 100 behind it, and each of the 9 checks with a fix when it fails. This checks craft, not how many views it may get.
curl https://getcutkit.com/api/v1/check \
-H "Authorization: Bearer $CUTKIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"body": "Your script words go here."}'Iterate. Check, read the fixes on the failing checks, edit the script, and
check again until nothing you care about still fails. A failing hook check lists templateIds, the templates that fit, so read one with GET /api/v1/templates/{id}.
Or send the same body to POST /api/v1/rewrite and you get back a
rewrite that fixes the failing checks. It saves nothing, so read it before you keep it.
Check your key.
curl https://getcutkit.com/api/v1/me \
-H "Authorization: Bearer $CUTKIT_API_KEY"Create a script. Send body, the words to read out loud, and
optionally title and pinned. With no title, the body's first line
becomes the title.
curl https://getcutkit.com/api/v1/scripts \
-H "Authorization: Bearer $CUTKIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title": "Launch video intro", "body": "Hi, I'"'"'m Sam. Here is what we shipped."}'Answers 201:
{
"script": {
"id": "0b8f6c1e-4f5d-4c2a-9a57-6e1d3f0c2b91",
"title": "Launch video intro",
"body": "Hi, I'm Sam. Here is what we shipped.",
"pinned": false,
"words": 8,
"created_at": "2026-09-29T18:04:11.201Z",
"updated_at": "2026-09-29T18:04:11.201Z",
"deleted": false
}
}List, change and delete.
curl https://getcutkit.com/api/v1/scripts \
-H "Authorization: Bearer $CUTKIT_API_KEY"curl -X PATCH https://getcutkit.com/api/v1/scripts/0b8f6c1e-4f5d-4c2a-9a57-6e1d3f0c2b91 \
-H "Authorization: Bearer $CUTKIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"pinned": true}'curl -X DELETE https://getcutkit.com/api/v1/scripts/0b8f6c1e-4f5d-4c2a-9a57-6e1d3f0c2b91 \
-H "Authorization: Bearer $CUTKIT_API_KEY"The script object
idstring- 8 to 64 letters, digits, dashes or underscores. A UUID when you don't choose one.
titlestring- One line, at most 200 characters.
bodystring- At most 200,000 characters. Empty on a deleted script.
pinnedboolean- Pinned scripts sit at the top of the library.
wordsinteger- Read only. What the phone counts to estimate reading time.
created_at,updated_atstring- ISO 8601, set by the server.
deletedboolean- Only ever true in an answer to
?since=.
Syncing
To keep a copy in step, call GET /api/v1/scripts once, keep its server_time, and pass it back as since next time. You get every
script that changed at or after that instant, oldest first, deleted ones marked deleted: true.
GET /api/v1/scripts?since=2026-09-29T18:00:00.000Z
{
"scripts": [
{ "id": "…", "title": "Launch video intro", "deleted": false, … },
{ "id": "…", "title": "", "body": "", "deleted": true, … }
],
"server_time": "2026-09-29T18:10:00.000Z"
}The phone does exactly this. It chooses its own ids and pushes with PUT, so a
script made offline lands once however many times the push is retried. The last write
wins.
Errors and limits
Refusals all share one shape, with a code you can branch on:
HTTP/1.1 401 Unauthorized
{
"error": {
"code": "invalid_key",
"message": "That API key isn't valid. It may have been rotated in the app.",
"docs": "https://getcutkit.com/docs/api"
}
}The codes: missing_key, invalid_key, invalid_json, invalid_body, missing_body, invalid_title, title_too_long, body_too_long, invalid_pinned, invalid_labels, too_many_labels, invalid_status, invalid_id, invalid_since, invalid_family, unknown_template, invalid_topic, invalid_topics, not_found, already_exists, library_full, rate_limited, too_short, too_long, check_limit, check_unavailable, not_configured, invalid_shelf, invalid_query, invalid_page, account_required, library_needs_pro, library_limit, library_unavailable, not_connected, arena_search_needs_premium, invalid_provider, invalid_file, invalid_signature, logo_not_found, logo_pending, logo_unavailable, internal.
- At most 2,000 scripts in a library (409
library_full). - At most 5 new libraries an hour from one address (429
rate_limited). - 401 means the key is missing or no longer valid. Ask the person for their current key.
Questions or a missing endpoint: hello@getcutkit.com.