Agent docs

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

  1. 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.

  2. Connect your agent

    In ChatGPT or Claude, add this address as a connector, then sign in.

    Connector address
    https://getcutkit.com/mcp

    Anything else takes your API key. Get your key.

  3. 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.

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.

Connector address
https://getcutkit.com/mcp

Claude (claude.ai and the desktop app)

  1. Open CutKit in Claude's connector directory.
  2. Press Connect.
  3. Sign in to CutKit and press Allow.

ChatGPT

  1. Open CutKit in ChatGPT's plugins.
  2. Press Install plugin.
  3. 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:

Terminal
claude mcp add --transport http cutkit https://getcutkit.com/mcp \
  --header "Authorization: Bearer ck_your_key"

Or in a config file:

JSON
{
  "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.

  1. Open CutKit on your iPhone and tap the key button at the top of the Scripts list.
  2. Turn on Agent access. The app makes your library and shows the key.
  3. 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:

Prompt
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).

Terminal
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 stdio

Commands 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/templates Every 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}/scripts Save a new script from a template's scaffold. Send a title, pin or labels.
  • POST/api/v1/check Check a script by body or id: grade, score, failing checks and their fixes. It doesn't predict views.
  • POST/app/api/check Check the signed-in web editor's body.
  • POST/api/v1/rewrite Rewrite a script by body or id so its failing checks pass. Saves nothing. 50 a day.
  • POST/app/api/rewrite Rewrite the signed-in web editor's body.
  • GET/api/v1/scripts Live scripts, pinned first then newest. With ?since=, every change since then.
  • POST/api/v1/scripts Create 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/labels Every 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}/color Color a label, or send null to clear it. The phone shows the same color.
  • GET/api/v1/me Check a key: its library and how many scripts it holds.
  • DELETE/api/v1/me Delete the library, every script and the key.
  • POST/api/v1/keys/rotate A new key for the same scripts. The old one stops at once.
  • POST/api/v1/keys Make 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.

Terminal
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.

Terminal
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.

Terminal
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.

Terminal
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:

JSON
{
  "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.

List
curl https://getcutkit.com/api/v1/scripts \
  -H "Authorization: Bearer $CUTKIT_API_KEY"
Pin
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}'
Delete
curl -X DELETE https://getcutkit.com/api/v1/scripts/0b8f6c1e-4f5d-4c2a-9a57-6e1d3f0c2b91 \
  -H "Authorization: Bearer $CUTKIT_API_KEY"

The script object

id string
8 to 64 letters, digits, dashes or underscores. A UUID when you don't choose one.
title string
One line, at most 200 characters.
body string
At most 200,000 characters. Empty on a deleted script.
pinned boolean
Pinned scripts sit at the top of the library.
words integer
Read only. What the phone counts to estimate reading time.
created_at, updated_at string
ISO 8601, set by the server.
deleted boolean
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.

HTTP
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
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.