# Example prompts

Things to say to an agent that has this server connected. Each shows which tools
should answer it — useful for telling whether you got a corpus answer or a guess.
They are written to work verbatim against a fresh trial.

> **Gotcha** — If an agent answers a corpus question without calling anything, it invented the
> answer. Ask it which tool it used.

## Find work

The front door. Every one of these starts with a search.

| say this                                                                                       | should call                           |
| ---------------------------------------------------------------------------------------------- | ------------------------------------- |
| Find React Native postings from the last month with a verified client, and rank them by score. | `search_jobs` → `get_job_score`       |
| How many Upwork postings mention Claude API right now? Show me the ten most recent.            | `search_jobs` (read `matched`)        |
| Show me every Django posting with a budget over $5,000 — all of them, not just the first page. | `search_jobs` paging on `next_cursor` |

## Judge a client

Only works on a posting a search has already shown you.

| say this                                                                            | should call                           |
| ----------------------------------------------------------------------------------- | ------------------------------------- |
| Who is the client behind this posting, and do they actually pay?                    | `get_buyer` → `get_buyer_quality`     |
| I want to quote $70/hour on this job. Have they ever paid that?                     | `get_buyer_quality` with `ask`        |
| How much of this client's history do you actually have? Should I trust the verdict? | `get_buyer_quality` → read `coverage` |

## Read the market

Aggregates only. Nothing here identifies a client.

| say this                                                                               | should call                       |
| -------------------------------------------------------------------------------------- | --------------------------------- |
| Is demand for Next.js rising or falling? Use complete weeks only.                      | `skill_demand` → `trend`          |
| What do freelancers list for Django in Poland, and how does that compare to worldwide? | `rate_benchmark` twice            |
| Is it worth me learning n8n? Show demand and rates.                                    | `skill_demand` + `rate_benchmark` |

## Be told instead of asking

Set it once; matches arrive on their own.

| say this                                                                                          | should call                        |
| ------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Watch for new Python scraping jobs from verified clients over $2,000 and post them to my webhook. | `check_prefilter` → `save_search`  |
| Before you save that, how many postings would it have caught last month?                          | `check_prefilter` (read `matched`) |
| What am I currently watching, and is any of it running?                                           | `list_saved_searches`              |

## Ask about yourself

Free, and readable on every plan state.

| say this                                                          | should call                       |
| ----------------------------------------------------------------- | --------------------------------- |
| How much of today's quota have I used?                            | `get_plan` → `usage`              |
| What did you call in the last hour, and did anything get refused? | `get_activity`                    |
| Why did that last search fail?                                    | `get_activity` → the refusal text |