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

# Example prompts

> Copy-ready prompts for asking your AI client about visibility trends, competitors, cited sources, ChatGPT shopping, demand and agents through the Quotable MCP server.

Each prompt below works with the Quotable MCP server connected and lists the scopes it needs. Copy one into your AI client and replace the brand name with yours. If you track one brand, you can leave the name out.

> [!TIP]
>
> Name the brand and the period in your question. Your assistant finds the brand's id with `list_projects` and turns "last week" into dates for `get_visibility`.

## Visibility

**Weekly visibility pulse.** Needs `read:projects` and `read:visibility`.

Using Quotable, get the daily visibility for Acme over the last 14 days. Compare the average visibility score and mention rate of the last 7 days with the 7 days before. Tell me the direction and size of the change in one sentence, then list the three days with the biggest day-over-day moves. Use only the data the tool returns, and say so if any days have no tracking data.

**Month-over-month trend.** Needs `read:projects` and `read:visibility`.

Using Quotable, get Acme's visibility from the first day of last month to today. Give me a weekly table with average score, average mention rate and Acme's average share of voice, and describe the trend in two sentences.

## Competitors

**Competitor share of voice.** Needs `read:projects` and `read:visibility`.

Using Quotable, get Acme's visibility for the last 30 days. From the share\_of\_voice field, rank every brand by its average share of voice over the period, and show which brands gained or lost the most between the first and last week. Point out any brand I might not be tracking as a competitor.

**Who's winning the conversation.** Needs `read:projects` and `read:visibility`.

Using Quotable, find the days in the last 90 days when a competitor's share of voice was higher than Acme's. Group them into streaks and tell me which competitor led most often.

## Citations and sources

**Which sources to pitch.** Needs `read:projects` and `read:visibility`.

Using Quotable, list the 50 pages AI answers cite most for Acme's prompts. Leave out pages on acme.com. Group the rest by domain and sort the domains by total times cited. For the top ten domains, say what kind of site each one is (review site, publication, community, competitor, other) and suggest whether to pitch it, contribute to it or monitor it.

**Community footprint.** Needs `read:projects` and `read:visibility`.

Using Quotable, list the cited pages for Acme whose domain contains "reddit", then do the same for "youtube". Summarize which threads or videos are cited most and how recently they were last seen.

**Own-site citations.** Needs `read:projects` and `read:visibility`.

Using Quotable, list the cited pages for Acme filtered to the domain "acme.com". Which of our pages do AI answers cite most, and which were retrieved often but cited rarely?

## ChatGPT shopping

**Shopping carousel check.** Needs `read:projects` and `read:visibility`, on a plan with Shopping.

Using Quotable, get Acme's ChatGPT shopping overview for the last 30 days. Which products does ChatGPT recommend most, how often are ours in slot 1, and on which prompts does a competitor win a carousel we're missing from?

**One product up close.** Needs `read:projects` and `read:visibility`, on a plan with Shopping.

Using Quotable, take Acme's most recommended product from the shopping overview and get its details. Which products outrank it, on which prompts does it lose, and which attributes were rivals judged on that it wasn't?

## Demand

**Demand research.** Needs `read:projects` and `read:demand`.

Using Quotable, list the demand terms behind Acme's prompts. Rank the terms that have data by AI volume, and use each term's monthly series to flag the ones that grew for three months in a row. Ignore terms whose status isn't "ok".

**Prioritize prompts by demand.** Needs `read:projects`, `read:visibility` and `read:demand`.

Using Quotable, list Acme's active prompts with their demand scores, and search the demand terms for the main words in the top five prompts. Recommend which three prompts deserve content first, and explain why in one sentence each.

## Agents and tables

**Read a table.** Needs `read:projects` and `read:tables`.

Using Quotable, list Acme's tables, then read the rows of the competitor table. Keep only the Company and Summary columns and group the companies by what their summary says about pricing.

**Run an agent.** Needs `read:projects`, `read:agents` and `run:agents`. The run uses your workspace's credits, and most clients ask before starting it.

Using Quotable, list Acme's agents and show me the inputs the competitor research agent needs. Run it for Globex, wait until the run finishes, and summarize the result.

## Writing better prompts

* **Ask for the data before the opinion.** "List the cited pages, then group them" gets more reliable answers than "what should I do about citations?"
* **Ask for more than one page when you need it.** Tools return 20 items by default and up to 100. Say "list all" or "the top 50" and your assistant follows `next_cursor` or raises `limit`.
* **Stick to what the tools return.** Visibility is per brand and per day, and citations are per brand. The MCP server doesn't break visibility down by engine or citations down by prompt.

## Next steps

> [card] [Workflows](https://docs.usequotable.com/mcp-server/workflows.md)
>
> Chain these prompts into repeatable routines.

> [card] [Tools reference](https://docs.usequotable.com/mcp-server/tools.md)
>
> Exactly what each tool returns.

> [card] [Authentication](https://docs.usequotable.com/mcp-server/authentication.md)
>
> Scopes each prompt needs.


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