list_jobs
List your recent background jobs — crawls and Search Console pulls — newest first, with each job_id. Use it when you do not have a job_id to hand.
Cost: Free (0 credits).
list_jobs lists your recent background jobs — the crawls and Search Console pulls that run in the background — newest first, each with its job_id. It is the tool to reach for when you do not have a job_id to hand. The reply says how many jobs you have in total and how many it did not show, so a cut list never reads as your whole history.
What it does
Reads your own jobs, scoped to your account, and returns one line each: which tool ran, what state it is in, when it was created and finished, which of your sites it ran against, and the job_id to ask about. The site is named by DOMAIN; a job with no project scope says so, and a project you have since removed falls back to the id it was recorded with.
A job whose stored stamps contradict each other — a finished earlier than its created — is marked timestamps out of order rather than printed as an ordinary timeline. Both stamps are still shown, because both are real: some rows were written with created_at stamped at insert time, after the work they record. No duration is derived from such a pair; a contradiction does not describe a short run, it describes an unknown one, and get_job_status makes the same refusal.
What the list shows, and what needs a second call
The list deliberately carries no results. A finished crawl or Search Console pull can store a very large result — one measured pull held close to a megabyte — so printing even a few of them would bury the answer you asked for.
Take a job_id from the list and pass it to get_job_status for that one job's detail: its crawl summary, how far a running job has got, or why it failed.
Example
Ask your MCP client in plain language:
How is the crawl I started doing?
The tool replies with your recent jobs; pick the one you mean and ask get_job_status about its job_id.
Input
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No | How many recent jobs to return (1-50, default 10). |
Returns
One line per job — tool, status, timestamps, project_id where there is one, and job_id — newest first, followed by a pointer to get_job_status for the full result. Guidance to the two tools that create jobs when you have run none.