# list_messages

Source: https://modulify.ai/docs/mcp/chat/list-messages

Reads the conversation between the site owner and the agent that builds the site.

- Title: Read site chat history
- Scope: `chat:read`
- Access: Read only

One call returns the 10 newest messages, ordered oldest first inside that page, alongside `hasMore` and `oldestCursor`. While `hasMore` is true, send `oldestCursor` back as `cursor` to get the 10 before those, and repeat until it is false. A cursor in any other shape is refused with `That page cursor is not valid. Ask for the first page instead!`

Messages still queued to run are left out, and `list_queued_messages` reads those. Use it to see what has already been asked and built before sending a new message. See [Site chat](https://modulify.ai/docs/build/site-chat).

## Inputs

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `projectId` | string | Yes | The site id. |
| `cursor` | object | No | The `oldestCursor` object from the previous response, with the fields `Created_At` and `Id`. Leave it out to read the newest page. |