# list_inbox

> Page: https://docs.flung.dev/reference/mcp/list-inbox. Index of every page: https://docs.flung.dev/llms.txt

List comments and mentions. Comments on the accounts' posts and mentions of them, newest first. Pass status unread for what needs an answer.

## TL;DR

| Question | Answer |
|---|---|
| What does it do? | Comments on the accounts' posts and mentions of them, newest first. Pass status unread for what needs an answer. |
| Does it change anything? | Reads only. |
| Which endpoint does it call? | [`GET /v1/inbox`](https://docs.flung.dev/reference/api/get-v1-inbox.md) |
| Which server? | `https://mcp.flung.dev/mcp-oauth` (sign in) or `https://mcp.flung.dev/mcp` (API key). |

## Arguments

| Argument | Type | Required | Description |
|---|---|---|---|
| `status` | `"unread" \| "read" \| "replied" \| "archived"` | no |  |
| `accountId` | `string` | no | An account id (acct_...) from list_accounts. at least 1 character; at most 64 characters; pattern `^acct_[a-z2-7]+$`. |
| `postId` | `string` | no | A post id, such as post_... at least 1 character; at most 64 characters; pattern `^post_[a-z2-7]+$`. |
| `limit` | `integer` | no | minimum 1; maximum 50. |
| `startingAfter` | `string` | no | at most 64 characters. |

## Example call

```json
{
  "name": "list_inbox",
  "arguments": {
    "status": "unread"
  }
}
```

## Things a person might say

- "Any new comments?"
- "What did people say about the launch post?"

## Annotations

| Hint | Value |
|---|---|
| `readOnlyHint` | true |
| `destructiveHint` | false |
| `idempotentHint` | true |
| `openWorldHint` | false |

## See also

| Doc | Why |
|---|---|
| [MCP tools](https://docs.flung.dev/reference/mcp.md) | Every tool |
| [Connect an AI agent](https://docs.flung.dev/mcp.md) | Install the server in your client |
| [`GET /v1/inbox`](https://docs.flung.dev/reference/api/get-v1-inbox.md) | The same operation over HTTP |