# Render a neighbourhood as a diagram

`GET /api/v1/graph`

MCP tool: `render-graph`

`focus=ready` draws the morning picture: the ready set and what each of them unblocks. A task id draws that task's neighbourhood instead.

## Parameters

- `focus` (query, required) — `ready` for the morning picture, or a task id for that task's neighbourhood.
- `project` (query, optional) — Only these `proj_…` ids (repeat or comma-separate); omit for all of yours. One you are not a member of answers `404`.
- `depth` (query, optional) — How many edges out from the focus. Defaults to 2.
- `limit` (query, optional) — How many tasks to draw at most: for `ready`, the strongest ready tasks, with what they unblock beside them; for a task, the nearest. Defaults to 40; `total` says how many the focus matched.
- `link_kinds` (query, optional) — The edge kinds to draw. Defaults to `blocks`.
- `format` (query, optional) — Defaults to `mermaid` — the client renders it. One of: mermaid, text.

## Responses

- `200` — The rendered neighbourhood
- `400` — The query string does not match the operation's schema
- `404` — No such task, or a `project` naming one this caller is not a member of