Nutcracker MCP Server

by heynutcracker Your server? Claim it

answering

Nutcracker is answering right now. Last checked 4 min ago. It exposes 23 tools.

Creative work for brand teams: strategy, copy, ideas, research, decks, key visuals and video ads.

Uptime history 12 hours of history

12 hours agonow

100.0%

Uptime 24h

44 of 44 checks

Tools

read from the server

199 ms

Response time

average over 24h

open, no key

Access

streamable-http

Nothing serious here today

Today is the operative word: we check Nutcracker every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 4 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add nutcracker --transport http https://heynutcracker.com/mcp

Settings → Connectors → Add custom connector, then paste this address

https://heynutcracker.com/mcp

~/.codex/config.toml

[mcp_servers.nutcracker]
url = "https://heynutcracker.com/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "nutcracker": {
      "url": "https://heynutcracker.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "nutcracker": {
      "type": "http",
      "url": "https://heynutcracker.com/mcp"
    }
  }
}

Available tools 23

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

doc

create_doc

Make a new doc in a space from your Markdown, for material a task should read (pass its id in doc_ids) or a text your human wants kept. It starts private to your human; the team sees it once shared or pinned. A body in a file on your disk: leave out content, then send the file to the upload_url you get, e.g. curl -T <path> '<upload_url>'; the answer is the new doc, and each send makes another. The link works for 15 minutes.

read_doc

Read a doc, presentation or storyboard as it is now, including edits the team made in the app. A doc comes back as Markdown and a presentation as its JSON. A storyboard comes back as its script: treatment, cast, each film's shots with seconds, action and lines, and a link to each picked frame. An evidence-card-ref fence is an exhibit the doc shows: keep it as it is when you rewrite the text.

update_doc

Change a doc's text and nothing else in it. One passage: old_text and new_text. Add to the end: append_text. The whole body: content and updated_at from your read_doc, refused when anyone edited it since, so you never overwrite the team. The text it replaces stays in the doc's version history. Presentations and storyboards change only through a task.

update_doc_info

Rename a doc, presentation or storyboard, file it in a space, or set who can open it. visibility org opens it to the team (ask your human first); a doc still in its task chat is filed in the chat space for that. visibility private also takes it off the web and out of its space's pins, and only its creator can set it.

space

create_space

Make a space when list_spaces has none that fits. If this place already has a space with the name, that one comes back with created: false instead of a second. A sub-space (parent_id) also reads its parent's pinned docs and elements, and takes its parent's scope. Otherwise scope decides who sees it: personal, the default, is your human alone; team is everyone in the workspace, so make a team space only when your human agrees.

list_space

Everything in one space: docs (type doc, deck for a presentation, or storyboard), chats, rolls of images and video, and uploaded assets, newest first, with app links and whether a doc has a public link. Pass cursor to read on. pins lists what every chat here reads, parent spaces included.

credits

get_credits

The workspace's credits left, before you plan or agree to media spend. unlimited means no credits limit spending and prices are for reference, since nothing is deducted; still ask your human before generate. blocked says why it can spend nothing now, and fix who can add more.

duplicate

duplicate_doc

Copy a doc, presentation or storyboard to start the next round from, keeping the original as it is. The copy is private to your human and lands in the same space when they can open it; comments, versions and sharing stay behind. A storyboard's copy picks from the same roll, and a presentation's drops slides not written yet.

elements

list_elements

The @elements of a space (a character, product or place with its reference sheet), including those it inherits from parent spaces: each name, description and media urls. Elements of a single roll are in read_roll.

export

export

A file of a doc, presentation or storyboard to download and attach: pdf or docx for a doc, pptx or pdf for a presentation, the frames as a zip for a storyboard (full size; zip_small to attach to a mail). To see how a presentation is drawn, read its pdf, or one slide as png with slide_id. Returns a download url that works for 15 minutes; the file is made when the url is fetched, which can take up to a minute for a presentation. An X-Missing-Pictures response header counts pictures that could not be reached and were left out.

generate

generate

Run one image or video card from get_task: this spends the workspace credits, so ask your human first, naming the card and its price. Refused when the price is no longer accept_price or the card now leaves out other images; read get_task again without seen then. The result lands in the task roll; poll get_task for files.

models

list_models

The models this user can use. image, video and sound: house default first, with sizes, ratios, lengths and what each takes. A task uses the default unless the brief or reply names one; prices show on the cards get_task returns. writer: the models another_ai on reply can name.

pin

Pin a doc, presentation or storyboard to its space, so every chat in the space and its sub-spaces reads it: brand rules, a brief, a source the work must rest on. A doc still in its task chat is added to that chat's space first. A pin is team material: when it would share a private doc with the team or turn its reuse back on, this is refused; ask your human, then call again with share: true.

reply

Send the next message in a task once get_task says it is not running: answer its question (an option or your own words) or ask for a revision. Or, in place of a message, pass another_ai for another model to write its own version of the latest reply, kept beside it in the app. Returns the same task_id; poll get_task again.

roll

read_roll

Read one roll of images, video and sound, newest first: each generation with its status, file urls and prompt (long ones end in …, a repeat reads "Same prompt as above."), and the roll's own @elements; list_elements has the space's. Pass query to find "the one where…" by words in its prompt, cursor to read on, or generation_ids for those generations with full prompts. Roll ids come from list_space or a storyboard.

save

save_reply_to_doc

Keep the answer a task's latest finished reply ends with as a doc of that task, word for word, with its sources and evidence, so another task can read it (doc_ids) or you can pin, share or export it. The opening line and progress notes it wrote between steps are left out.

share_link

Publish a doc, presentation or storyboard: returns its public read-only link, which anyone with the link can open without an account. Returns the existing link when there is one. The link shows in the doc Share panel.

spaces

list_spaces

Spaces in the connected workspace this user can open, most recently active first. path shows nesting ("Kova / Winter launch"): a sub-space also reads its parents' pinned docs and elements. scope says who sees the work: team is everyone in the workspace, personal is your human alone. Pass query to find one by name.

start

start_task

Start a creative task (writing, strategy, naming, ideas, research-backed docs) as a new Nutcracker chat in a space; the space brand memory and pins apply. Returns task_id and the chat url. A task takes minutes: poll get_task until it is no longer running.

task

get_task

Where a task stands: running, needs_input (answer the question with reply), done, or failed. While running, progress names the step in flight (research, skill, ...; null while it thinks or writes the reply), its latest headline, and how many sources research has read. Returns the answer the latest reply ends with (a failed task: all it wrote) with evidence as links and [image card: name] where a card stands, the sources it cites, the skills it used, the other AI behind a take, the documents the task made (id, title, url), its images, video and sound with file urls and the credits each spent, and the image and video cards of the latest reply with their price: run one with generate once your human agrees to the price.

unpin

unpin

Stop new chats reading a pin, when a round changes direction. Take pin_id and space_id from list_space; a pin held by a parent space comes off that space and everything under it. The doc itself stays, with the same access.

unshare

unshare

Turn off the public link of a doc, presentation or storyboard. Anyone opening the old link gets nothing; a copy someone already saved stays with them.

upload

upload_file

Get a link to send one image, video or document from your disk (logo, screenshot, product shot, PDF) for a task to work from. Send the file with an HTTP PUT, e.g. curl -T <path> '<upload_url>'; the answer is JSON with the file_id to pass in files on start_task or reply. The link works for 15 minutes. One file_id works for any number of tasks. Up to 100 MB; compress anything larger. Upload an image or video right before the task that uses it: about 20 can wait unsent, and waiting ones also block your human uploading in the app. A large scan can take minutes to read; start_task says when it is not ready yet.

Endpoints

URL	Transport	State	Latency	Checked
https://heynutcracker.com/mcp	streamable-http	answering	202 ms	4 min ago

Alternatives to Nutcracker

same job, measured the same way

Styleforge

by styleforge

Brand-aware creative studio for Claude: 200+ tools for on-brand ads, video, email and campaigns.

answering

RoryPlans

by roryplans

AI work orchestration for plans, tasks, teams, and coding-agent dispatch.

answering

Approval Studio

by approval

Approval Studio is an online proofing software for creative teams and everyone working with designs

answering

SpecStream

by specstream

The live web data engine for teams and agents: Search API, Extract API and Deep Search.

answering

kloudboard

by kloudboard

Boards, cards, tasks, review, Drive and AI tools for content teams and YouTube creators.

answering

Kody

by kody-hq

Your agents' cloud for individuals and teams. Search, execute, packages, jobs, and credentials.

answering

Kody

by kentcdodds

Your agents' cloud for individuals and teams. Search, execute, packages, jobs, and credentials.

answering

BoardMark

by boardmark

Issue board for teams: find, create and move issues, run sprints, comment and keep project docs.

answering

Nutcracker — questions

Answers built from our own checks of this server.

What can Nutcracker do?

It exposes 23 tools, read directly from the server on our last check. Among them: create_doc, create_space, duplicate_doc, export, generate, get_credits and 17 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Nutcracker mostly used for?

Its tools cluster around doc and space. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Nutcracker working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 44 of 44 checks got a reply (100.0%), average response time 199 ms. The bar chart above shows every period we have measured.

How do I connect Nutcracker?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Nutcracker need an API key?

No. Nutcracker completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 23 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Nutcracker?

It answers our handshake in 199 ms on average, which is faster than 67% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.