> ## Documentation Index > Fetch the complete documentation index at: https://docs.contenthero.ai/llms.txt > Use this file to discover all available pages before exploring further. # Planner > Spaces, stages and cards: the content pipeline, and publishing from it. Spaces, stages and cards: the content pipeline, and publishing from it. 20 tools. Every tool below is exposed by the hosted MCP server at `https://mcp.contenthero.ai` and by the `@contenthero/mcp` npm package. A write tool changes your account; a read tool does not. ### `list_spaces` read List the account's SPACES. A space is the planner's top-level container: Space > Stage > Card > Post. Each space has its own stages, so two spaces can both hold a stage called 'Published'. Call this FIRST to discover which board to work in, then pass a space id to list\_stages, list\_cards or create\_card. Archived spaces are excluded unless archived is set, which lists only them. Only archived spaces. Archived spaces are excluded by default, matching the grid in the app. The previous page's cursor. Only favorited spaces. How many to return. The sort direction. Search space names. The field to sort by. ### `get_space` read Return one space with its live card count. Use list\_spaces to discover ids. The count excludes archived cards, and is the same number list\_spaces reports for that space. The space id. ### `create_space` write Create a space: a new planner board with its own stages. duplicateFrom copies another space's STAGES, never its cards, so the new board arrives with the columns and none of the work. Requires the planner:write scope. The space name. A cover image URL for the space tile. Copy this space's stages into the new one. Cards are never copied. ### `update_space` write Rename a space or change its cover. This is a PATCH: a field you omit is left alone, so renaming does not disturb the cover. Pass coverUrl as an empty string to REMOVE the cover. To favorite or archive a space, use the `favorite` and `archive` tools with assetType 'space' instead. Requires the planner:write scope. The space id to update. A new cover image URL. Pass an empty string to remove the cover entirely. A new name. ### `delete_space` write Delete a space. The server REFUSES a space that still holds cards and names the count, because the delete cascades to every card in it along with their covers, captions, posts and schedules. Archive the space instead if you want it out of the way. Requires the planner:write scope. The space id to delete. ### `list_stages` read List one SPACE's stages, in order. ⚠️ STAGES ARE PER-SPACE: without spaceId this is the account's DEFAULT space, and two spaces can each hold a stage named 'Published' with different ids, so a stage name resolved against the wrong space is a different column. Stages are user-customizable (renamed, reordered, added, removed), so call this to discover the real stages before placing a card; pass a stage's id (most stable), slug, or name to create\_card / update\_card. The previous page's cursor. How many to return. Which space's stages, from list\_spaces. Omit only when you mean the account's default space. ### `create_stage` write Create a stage (a column on one board). ⚠️ STAGES ARE PER-SPACE: without spaceId this creates on the account's DEFAULT board, which is rarely what you want once more than one space exists, so call list\_spaces first. The slug is DERIVED from the name and is not settable; a board cannot hold two columns whose names produce the same slug and the server refuses the second rather than renaming it for you. Place the column with afterId, beforeId or position (top is the first column), or name none to put it at the end. Requires the planner:write scope. The column name, for example "In Review". Must contain a letter or number. Place it immediately after this item of the same list. Place it immediately before this item of the same list. A hex color such as "#3B82F6". Place it at an end of the list instead of beside an item. Name neighbors or a position, not both. Which board, from list\_spaces. Omit only when you mean the account's default space. ### `update_stage` write Rename, recolor or move one stage. This is a PATCH: a field you omit is left alone. ⚠️ spaceId is REQUIRED, because a stage id alone does not tell the server which board you mean and guessing the wrong one silently changes nothing. Renaming re-derives the slug, so renaming a column away from 'Published' also stops publishing auto-moving cards into it; a rename that collides with another column on the same board is refused. Moving names NEIGHBORS or an end, never a number: pass afterId, beforeId, or position (top is the first column). Requires the planner:write scope. The board this stage is on, from list\_stages or list\_spaces. The stage id to update, from list\_stages. Place it immediately after this item of the same list. Place it immediately before this item of the same list. A new hex color such as "#3B82F6". A new name. The slug follows it automatically. Place it at an end of the list instead of beside an item. Name neighbors or a position, not both. ### `delete_stage` write Delete a stage and move its cards to another column. The server REFUSES a column that still holds cards when you name no targetStageId, and tells you how many there are: cards are never destroyed by deleting a column, and the delete and the reassignment happen in one transaction. Returns the board that is left. Requires the planner:write scope. The board this stage is on. The stage id to delete, from list\_stages. Where this column's cards should go. Required unless the column is empty. ### `list_cards` read List one SPACE's cards (newest-updated first). ⚠️ SCOPED, NOT COMPLETE: without spaceId this lists the account's DEFAULT space only, and cards on any other board are absent with nothing in the response saying so (search misses them too). Call list\_spaces FIRST and pass spaceId unless you specifically mean the default board. Filter by status, platform, stage (id/slug/name), favorite, tag, or a title search. Call get\_card for one card's full detail (posts + assets). Only ARCHIVED cards. Archived cards are excluded by default, matching the board. The previous page's cursor. Only favorited cards. How many to return. The sort direction. Filter by the post platform. Case-insensitive title search, scoped to the chosen space. The field to sort by. Which space's board to list, from list\_spaces, or 'all' for every space. Omit ONLY when you mean the account's default space; omitting it does not search every board. Filter by a stage id, slug, or name. Resolved within the chosen space. Needed for sort position, which reads that stage's own order. Only cards carrying this tag. ### `get_card` read Get one CARD in full: its fields (title, description, script, notes, status, stage, schedule), plus its posts (one per platform, which is how it publishes) and its attached assets in carousel order. An \[inspiration] asset is a tracked post attached as a reference; its line already carries the headline metrics (creator, outlier score, views, likes, duration) plus transcript and breakdown availability, and a content id to pass to get\_content for the transcript and the full Break It Down analysis. To attach one, add \{ contentId } to the assets list of update\_card; a linked editor or canvas project is added the same way with \{ projectId }. The card id from list\_cards. ### `create_card` write Create a card, the container in the content pipeline. A card holds the work (title, notes, cover) and the posts that publish it. Attach posts and media by passing `posts` and `assets` to update\_card, then publish with publish\_post. ⚠️ WITHOUT spaceId THIS LANDS ON THE ACCOUNT'S DEFAULT BOARD, which is rarely what you want once more than one space exists, so call list\_spaces first. `stage` accepts a stage id/slug/name and DECIDES the space when it is an id; a spaceId that disagrees with it is rejected rather than guessed. Requires a key with the planner:write scope. Primary platform for the post. Post title (required). Place it immediately after this item of the same list. Place it immediately before this item of the same list. A media token (short id, output id or first 8 characters, optionally with "-N") for the cover, resolved to its URL. Use this or coverUrl. Public URL for the post cover (the card thumbnail). Place it at an end of the list instead of beside an item. Name neighbors or a position, not both. Which board to create the card on, from list\_spaces. Omit only when you mean the account's default space. Stage id, slug, or name. Defaults to the first stage. Tag names to set on the post (must already exist; see list\_tags / create\_tag). Replaces the set. ### `update_card` write Update a card: its fields (title, notes, platform, cover, stage), its POSTS (one per platform, which is how it publishes), its ASSETS (its files, links, linked projects and inspiration posts, in order), and its SCHEDULE. posts and assets are DECLARATIVE: pass the WHOLE set, because anything you leave out is removed. Posts key on platform. Assets key on id, and THE ARRAY ORDER IS THE carousel ORDER, so reordering is just sending the same ids in a different order; keep an existing asset by id, and add a new one by EXACTLY ONE reference: outputId (media: a generation, an upload or an import), assetUrl (a link), contentId (an inspiration post, shown on the card's Inspiration tab) or projectId (an editor or canvas project); get\_card reads each back under the same field name. Listing the same thing twice is refused. To attach one thing, read the card, append the entry to its assets, and send the whole list back. scheduledAt sets the time on the card AND every post (pass null to clear); give a post its own scheduledAt to override it for that platform. To publish NOW, use publish\_post. Pass spaceId to MOVE the card to another space; without a stage it lands in the target space's stage whose slug matches its current one, or that space's first stage. Pass cardIds to update several cards at once, which crossed with spaceId is how a selection moves in one call; fields that describe ONE card (title, notes, cover) still need exactly one. WRITING notes REQUIRES expectedRevision: read the card first and pass the revision it reported, or the call is refused. Requires the planner:write scope. The card id. Place it immediately after this item of the same list. The post's assets IN ORDER, each \{ id } to keep an existing one or ONE of \{ outputId } | \{ assetUrl, assetType? } | \{ contentId } | \{ projectId } to add. REPLACES the list; \[] clears it. Place it immediately before this item of the same list. Update several cards at once. Fields that describe ONE card (title, notes, cover) still require exactly one. A media token (short id, output id or first 8 characters, optionally with "-N") for the cover, resolved to its URL. Public URL for the post cover. REQUIRED when writing notes: the revision get\_card reported for this card. A card's notes have four independent writers, each reading the whole document and writing it back, so without this the last writer silently erases the others and still gets a success. If the card changed since you read it, the call fails with a conflict carrying the current notes and revision: merge onto those and retry with the revision they came with. Never guess it or add one to it, because it only advances when notes actually change. Working notes on the card. Plain text or markdown; tables render here. No emojis. Change the notes in place without resending them. Each edit is \{ append: text }, which adds to the end, or \{ find, replace }, where find must match exactly one place in the current notes. Edits apply in order, all or none, to the notes as they are when the call arrives, so no expectedRevision is needed. Prefer this to notes for any change smaller than a rewrite. The card's primary platform. This is a label on the card; what actually publishes is its posts. Place it at an end of the list instead of beside an item. Name neighbors or a position, not both. The card's posts, each \{ platform, format?, connectedAccountId?, platformSpecificData?, scheduledAt?, status? }. REPLACES the set, keyed by platform; \[] detaches all. ISO time to publish. Sets the card AND every post. null clears the schedule. Move the card to a different space (id or slug). Without a stage, it lands in that space's stage whose slug matches its current one, or that space's first stage. Move the card to this stage (id, slug, or name). Tag names to set on the post (must already exist; replaces the set). Omit to leave tags unchanged. Rename the card. Keep it short: a long title wraps and makes the column unreadable. ### `list_tags` read List the account's tags (the organizational tag library). Set a post's tags with the `tags` field on create\_card / update\_card. A tag is just a lowercase name. The previous page's cursor. How many to return. ### `create_tag` write Create a tag in the account's tag library (the name is lowercased). Tags organize posts; apply them with the `tags` field on create\_card / update\_card. Requires the planner:write scope. The tag name (lowercased on save). ### `update_tag` write Rename a tag (preserves its assignments on all posts). To detach a tag from one post, set that post's `tags` without it via update\_card. Requires the planner:write scope. The new tag name (lowercased on save). The tag id (from list\_tags). ### `delete_tag` write Delete a tag from the account's library. This DESTROYS the tag and removes it from every post it was on. To just detach a tag from one post, set that post's `tags` without it via update\_card instead. Requires the planner:write scope. The tag id (from list\_tags). ### `publish_post` write Publish a card's posts NOW: every post on the card, or only the named platform's post when `platform` is given. Each post must have a connected account. Requires a key with the publish:write scope; holding that scope is the account owner's consent to autonomous publishing. Returns one result per post. The card id to publish. Publish only this platform. Omit to publish all posts. ### `list_connected_accounts` read List the social accounts the owner has connected (the publish targets), default first. Use an account's id as connectedAccountId on a post in update\_card, then publish\_post. Read-only: connecting an account is done in the ContentHero app. The previous page's cursor. How many to return. ### `get_connected_account` read Get one connected account's detail: platform, status, and capabilities. Use it to confirm a target can publish before attaching it to a post. The connected account id from list\_connected\_accounts. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.