> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmarsell.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Marsell's MCP server is at https://getmarsell.com/mcp: agents connect with a key the owner makes in the app (a project's Agents page, Your own AI). See /developers/mcp for its tools. There is no public REST API yet; don't suggest REST endpoints.
> The search MCP server at https://docs.getmarsell.com/mcp only searches these docs. It can't read or change anyone's Marsell projects.
> Each business is a project with seven places: Home, Create, Market, Sell, People, Agents and Brand. 'Marsell plan' means the subscription (Solo, Core, Growth, Network); 'the plan' or 'the week' means the work Marsell has planned.
> Tokens are Marsell's unit for AI and media work, granted monthly by the Marsell plan. They are not model tokens.

# Chat with Marsell

> Ask Marsell about the plan and results, or tell it what to change: how to open the chat, what it can change, how it shows its work, and what it costs.

The chat bar sits at the bottom of every page: "Tell me what you want to make happen…". Ask Marsell about the plan and how it's going, tell it to change something, or tell it something your site doesn't say. It answers in a line or two, makes the change when it can, and lists what changed under the answer. Every answer uses tokens from your Marsell plan.

## Talk to Marsell

<Steps>
  <Step title="Open the chat">
    Click the bar, or press <kbd>/</kbd> anywhere you aren't typing. It grows into the conversation. <kbd>Esc</kbd> or ✕ closes it.
  </Step>

  <Step title="Write your message">
    Press <kbd>Enter</kbd> to send, or <kbd>Shift</kbd> and <kbd>Enter</kbd> for a new line. A message can run to 12,000 characters, so a pasted brief fits.
  </Step>

  <Step title="Watch it work">
    Marsell says what it's doing, such as "Reading the numbers", "Planning the work" or "Researching on the web", and ticks off each step as it finishes.
  </Step>
</Steps>

A new chat offers starting points such as "What are you doing this week?", "Which channel comes first, and why?", "Make a short film about what we do" and "We never post on Sundays".

## What you can ask

Marsell answers from what it has on file: where the project stands, the plan and what became of each piece, results, your numbers, the people it has been in touch with, what it has learned, and the conversations it found online. When nothing on file answers a question, it can look the fact up on the web.

## What it can change

| Ask for | What Marsell does |
| - | - |
| New work | Plans up to two pieces per message, checked like the rest of the plan |
| A different day, or less work | Moves or cancels a piece that hasn't gone out yet |
| Standing work | Starts, changes or stops a stream, such as posts a day on one channel |
| A test | Starts an experiment |
| Something to remember | Keeps what you tell it, such as "We never post on Sundays", and plans with it from then on |
| A correction to your look | Changes the description every picture and film is written from: the design language, aesthetics, motifs, imagery and what to avoid. A full rebuild costs about 1,200 tokens |
| A film | Plans or starts one, and opens it when it's under way |
| Changes to a film | On a film's page, reads it and changes it with you |

## Work that spends or posts

When Marsell wants to do something that spends tokens or posts, such as a voice take or a film render, it doesn't do it straight away. It shows a button with the price and the share of your month it uses: "Nothing is spent until you press it." If the price is more than you have left, the button offers **Add tokens** instead. A price more than a day old asks to be quoted again.

## Keep several chats

Click the chat's title to open **Your chats**. Switch chats, **Rename** or **Archive** one, and open **Archived** to **Restore** one. **New chat** starts a conversation with no history.

## How it shows its work

* **While it works:** Marsell, the step it's on, the steps done and the seconds so far.
* **In the answer:** what changed as a ticked list, the steps it took, the time and **Copy**.
* **If an answer fails:** "I could not answer that." with the reason and **Try again**.

## What the chat doesn't do

* **Answer cards for you.** Decisions under **What needs you** are yours. See [What needs you](/home/approvals).
* **Change your plan, billing or team.** Those are in the tokens sheet and your account.
* **Edit your colours, type, logo or brand words.** Change those on [Brand](/brand).
* **Take files.** Messages are text. Add pictures and documents on Brand.

## What it costs

Every answer is AI work, paid from your plan's tokens. An answer that only reads what's on file costs the least; web lookups, rebuilding your look and films cost more. Changes the chat makes appear under **Everything Marsell did** on Home with their tokens. When the month's tokens are used up, Marsell replies that it can only listen until you add tokens or change the plan. See [Marsell plans and tokens](/account/plans-and-tokens).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.