# Use cases (/docs/usecases)



Use-case browsing, search, and detail are free, with no account required. Optional bearer keys provide account-level rate limits and usage tracking.

## List or search [#list-or-search]

`GET /api/v1/usecases`

* `q` — optional search string, including recommended platforms and guide content
* `cursor` — next page from a previous list response
* `limit` — 1–100, default 20

Responses contain `data` and `nextCursor`. Each entry includes `slug`, `title`, `who`, `handle`, `roi`, `sourceUrl`, and `addedAt` for its original source, plus an optional `guide` for curated entries.

The guide has `title`, `category`, `opportunity`, `audience`, `platforms`, `botSlugs`, `steps`, `prompt`, and optional `value`. The value includes `amount` (USD display text), `label`, `basis`, and `kind` (`reported` or `illustrative`). Preserve the label and assumptions when suggesting ideas; time-value estimates and sample service fees are not earned revenue. Resolve each recommended bot through `GET /api/v1/bots/{slug}`. Guide recommendations are MMB editorial suggestions; creator-reported outcomes remain attributed to the original source.

## Get one [#get-one]

```bash
curl "$MMB_BASE_URL/api/v1/usecases/clip-bot"
```

The source is context for the idea. Validate the offer with a prospective customer; reported outcomes are not guaranteed results.

## Weekly inspiration [#weekly-inspiration]

Give your agent the database URL and ask it to propose ideas for your work. Follow `nextCursor` to read the full collection; use `slug` and `addedAt` to identify newly added use cases. Save previously reviewed slugs so weekly suggestions can focus on fresh inspiration. Set the routine up in your agent’s own scheduling tool. The website does not create a schedule when you copy a prompt.

Find the three copyable prompts on [For your agent](/#agent-access).
