{"id":"com.heynutcracker/nutcracker","slug":"com-heynutcracker-nutcracker","title":"Nutcracker","description":"Creative work for brand teams: strategy, copy, ideas, research, decks, key visuals and video ads.","version":"1.0.0","publisher":{"kind":"domain","id":"heynutcracker.com","label":"heynutcracker.com","url":"https://heynutcracker.com"},"website":"https://heynutcracker.com/connect","repository":"","remotes":[{"type":"streamable-http","url":"https://heynutcracker.com/mcp"}],"packages":[],"published":"2026-11-08","updated":"2026-11-08","status":"online","auth":"","latency_ms":3443,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_spaces","title":"List spaces","description":"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.","read_only":true},{"name":"create_space","title":"Create space","description":"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. If a space with a similar name exists anywhere, nothing is made and only those come back, as similar: use the one that is the same project, or call again with create_anyway: true when none is. A sub-space (parent_id) also reads its parent's","read_only":false},{"name":"merge_space","title":"Merge space","description":"Fold a duplicate space into another: its chats, docs, rolls, files, pins, collections, sub-spaces and memory move into into_id, and the emptied space goes to Trash. Both must sit under the same Personal or Team. This is refused until your human agrees: ask them, then call again with agreed: true. Only who made the space, or a workspace admin, can merge it. files_already_there in the result names t","read_only":false},{"name":"start_task","title":"Start task","description":"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.","read_only":false},{"name":"get_task","title":"Get task","description":"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 c","read_only":true},{"name":"answer_memory","title":"Answer memory suggestions","description":"Save or dismiss lines from get_task memory_suggestions, as your human answered. Saved lines join the space's memory and reach every chat in it; a dismissed line is not suggested again in that space. Returns each line's state; one answered in the app already keeps that answer.","read_only":false},{"name":"generate","title":"Generate media","description":"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.","read_only":false},{"name":"reply","title":"Reply to task","description":"Send the next message in a task: answer its question (an option or your own words) or ask for a revision. While the task runs, a message alone (no docs or files) reaches it at its next step: use that for what your human adds or corrects mid-task, not for status or a restated brief. Or, in place of a message, pass another_ai for another model to write its own version of the latest reply, kept besid","read_only":false},{"name":"list_models","title":"List models","description":"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 reply's another_ai can name; start_task's model takes only those with chat true.","read_only":true},{"name":"list_work","title":"List kinds of work","description":"The kinds of work Nutcracker knows, each with what it returns (gives), the shapes it starts from (takes) and the shape it hands on (makes). Shapes run brief, evidence, insight, strategy, idea, platform, execution; review judges finished work. Name one in the brief when it fits (\"run a Brand Scan\"); otherwise describe the outcome and Nutcracker picks.","read_only":true},{"name":"upload_file","title":"Upload file","description":"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. A document up to 100 MB, an image up to 20 MB. A video ","read_only":false},{"name":"get_credits","title":"Get credits","description":"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.","read_only":true},{"name":"read_roll","title":"Read roll","description":"Read one roll of images, video and sound, newest first: on the first page its reference shelf (references, the pictures, clips and sounds put beside it, up to 60, references_more counts the rest; in_prompt marks those on its prompt now), then 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_elemen","read_only":true},{"name":"list_elements","title":"List elements","description":"The @elements of a space (a character, product, place or voice with its reference media), including those it inherits from parent spaces: each element_id, name, description and media (media_id, kind, url, and seconds for video and audio). An inherited one names the space it comes from; change it there. Elements of a single roll are in read_roll.","read_only":true},{"name":"create_element","title":"Create element","description":"Make an @element in a space from images, a video or a voice you sent there, so every image and video made in the space and its sub-spaces keeps that character, product or place the same when a prompt names @name. Send each file with upload_file and space_id first. The answer has the element_id.","read_only":false},{"name":"update_element","title":"Update element","description":"Change one of a space's own @elements: its name, description or media. media_ids replaces the whole set, so pass the ones to keep (from list_elements) with the new ones; one it already holds keeps the trim set in the app. Change an inherited element in the space it comes from.","read_only":false},{"name":"move","title":"Move","description":"Move a chat, roll, space, collection or space file into another space (a doc moves with update_doc_info). A sub-space moves with everything in it; a space can also go to the top of Personal or Team with to_top_level. Collections and files stay under their own Personal or Team. A move that changes who can open something (a roll or space going between Personal and Team, guests gaining or losing a sp","read_only":false},{"name":"rename","title":"Rename","description":"Rename a space, chat, roll, collection, or a picture, clip or sound in a space's Files (kind media, with space_id). A doc renames with update_doc_info; an uploaded document keeps its name. Everyone who can open it sees the new name.","read_only":false},{"name":"delete_file","title":"Delete file","description":"Remove a file from a space's Files to Trash and off its pins; restoring it in the app within 30 days pins it again. A picture, clip or sound (media_id) is refused while the space collects it, names it as an @element or has it on a roll prompt, and the refusal says where.","read_only":false},{"name":"delete_space","title":"Delete space","description":"Send a space to Trash with everything in it: sub-spaces, chats, docs, rolls, files, pins and collections. It can be restored from Trash in the app for 30 days. This is refused until your human agrees: ask them, then call again with agreed: true. Only who made the space, or a workspace admin, can delete it. To keep the work, merge_space or move it first.","read_only":false},{"name":"read_doc","title":"Read doc","description":"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/> marker is an exhibit the doc shows (about and url say what it is): keep or move its m","read_only":true},{"name":"share_link","title":"Share link","description":"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.","read_only":false},{"name":"unshare","title":"Turn off link","description":"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.","read_only":false},{"name":"export","title":"Export","description":"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 t","read_only":true},{"name":"list_space","title":"List space","description":"Everything in one space: docs (type doc, deck for a presentation, or storyboard), chats and rolls of images and video, 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; files lists the space's Files, the documents every chat here can read; media lists the pictures, clips and sounds people brought","read_only":true},{"name":"create_doc","title":"Create doc","description":"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","read_only":false},{"name":"update_doc","title":"Update doc","description":"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.","read_only":false},{"name":"pin","title":"Pin doc, file or images","description":"Pin a doc, presentation, storyboard, space file or space images 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 agai","read_only":false},{"name":"unpin","title":"Unpin doc","description":"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 or file itself stays, with the same access.","read_only":false},{"name":"add_images","title":"Add images to collections","description":"Sort images you sent to a space (upload_file with space_id) into its collections, as a drop in the app: each lands in the collection and group it fits, and images that fit none start a new collection. The answer says where each landed, with app links, and gives a drop_id: undo_drop takes the whole drop back within a day. Sorting looks at every image, so a big drop takes up to a minute.","read_only":false},{"name":"undo_drop","title":"Undo a drop","description":"Take back an add_images drop: the images it added leave their collections, wherever they were moved since, and collections it started and left empty are deleted. An image it took out that no collection or pin holds is deleted after a day; send it again to sort it.","read_only":false},{"name":"duplicate_doc","title":"Duplicate doc","description":"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.","read_only":false},{"name":"update_doc_info","title":"Update doc info","description":"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.","read_only":false},{"name":"save_reply_to_doc","title":"Save reply to doc","description":"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.","read_only":false}],"server_info":{"name":"nutcracker","version":"0.1.0"},"category":"image-video","tags":["productivity","communication","marketing"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-08","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/com-heynutcracker-nutcracker/"}