# willo_read_file

> Read one file of the site code from GitHub at the draft branch when one is open, otherwise main.

Generated from Willo's code at each release.

Source: https://www.willo.ai/docs/reference/mcp-tools/willo_read_file

**Read a site file.** Returns a window of lines (default 500) with a header naming the range and how to continue, and the file's `sha` — willo_write_file needs it to replace the file. Free, read-only. Files over 1 MB and binaries are refused.

## Access

- **Token**: read or read + act.
- **Approval**: Never. This tool only reads.
- **Metered**: counts toward a per-business, per-minute limit for this kind of call. See [Limits](https://www.willo.ai/docs/reference/limits).

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `path` | string | yes | Repo-relative path, e.g. `src/pages/index.astro`. |
| `offset` | integer ≥ 1 | no | First line to return (1-based). Omit to start at the top. |
| `limit` | integer 1–2000 | no | How many lines to return (default 500, max 2000). |

## Related

- [All MCP tools](https://www.willo.ai/docs/reference/mcp-tools)
- [Error codes](https://www.willo.ai/docs/reference/errors)
- [Draft and live](https://www.willo.ai/docs/ai-agents/draft-and-live)