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

# Buyers and conversations

> How Marsell finds the communities your buyers gather in, reads their rules, and finds people asking for what you make, with a reply drafted in your voice for you to post.

Marsell looks for the places your buyers talk, reads each one's rules, and finds the threads where someone is asking for what you make. For each, it drafts a reply in your voice. You post it from your own account, or approve it and Marsell posts it for you on Reddit. Nothing goes into a community under your name without your yes.

## Where your buyers are

**Where your buyers are** in Market lists the communities, or crowds, your buyers gather in, with their members, how many posts a week, and their rules as chips: **No sales**, **No AI pictures**, **No AI content**, **No self-promotion**, and so on. Each crowd also says how Marsell behaves there: "I answer, never name you" or "I listen here, never post".

### What Marsell looks for

Above the crowds, one sentence says who Marsell searches for, in your kind of business's terms: "I look for people into … who buy …" for a shop, "I look for people in" your area "who need …" for a local business, "I listen for people … who need help with …" for a law firm.

To change it, press **Change** (or **Tell me**), then fill in **What people choose you for** (up to six, a few words each, such as "Y2K" or "AC repair") and **What they buy**, and press **Save**. Your words stay through every search. **Look now** searches again straight away; **Later** waits for the next search.

### Search again

**Find them** (the first time) or **Look again** searches the web and forums for crowds, rivals and conversations at once. The button shows what a search usually costs, about 2,000 tokens, and a search never costs more than 6,000. While it runs it shows what it has found so far; when it's done it says what it found and what it cost. Once Marsell has started, it also searches once a week and looks for new conversations every day.

## Conversations to join

**Conversations to join** shows threads where "Someone asked for what you make", from the last three weeks. Each card shows the community, how long ago, how well it fits, and the words that prove it.

<Steps>
  <Step title="Read the reply">
    Press **Read the reply**. Marsell's draft appears under **Reply, in your voice**. Chips say whether it names your business and the rule of the community it keeps to.
  </Step>

  <Step title="Post it yourself">
    Press **Copy & open**: the reply is copied and the thread opens. Post it there from your own account.
  </Step>

  <Step title="Tell Marsell">
    Press **I posted it**, paste the link to your reply, and press **Save**. The card shows **Posted**.
  </Step>
</Steps>

Below the threads, questions that came up more than once are grouped as "Asked again and again", worth a post or a page of your own.

## Replies on Reddit

The Reddit agent reads the subreddits that fit you, picks fresh posts from the last two weeks where you can genuinely help, and drafts up to three replies a run. Each comes to you as a card.

* **Without Reddit connected**, it reads every six hours. Press **Open the thread** and **Copy the reply**, post it yourself, then **I posted it**.
* **With Reddit connected**, it reads every 15 minutes, and **Post it from your Reddit account** posts the reply after your yes. Connect Reddit from [Agents](/agents#the-accounts-they-work-through).

A reply that names your business says you make it, and every Reddit post and reply waits for your yes. Marsell never answers threads about health, legal trouble or grief, and never sends DMs.

## Trends

The Trend agent reads what's being talked about each morning and hands Create the trends that fit you. A post about a trend always comes to you first.

## What Marsell won't do

* Post into a community without your yes.
* Vote, or ask and answer with different accounts.
* Pretend to be a customer, or hide that a reply comes from your business.

<CardGroup cols={2}>
  <Card title="Rivals" icon="swords" href="/market/rivals">
    Who your buyers compare you with.
  </Card>

  <Card title="People" icon="users" href="/people">
    Everyone who asked, in one place.
  </Card>
</CardGroup>


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