Fluxmail Cloud

Read thread

get_thread

Read-only

Read a page of messages in an email thread, with at most 50,000 body characters per page.

Input Schema

Name	Required	Description
`pageSize`	No
`threadId`	Yes
`accountId`	No	Account to operate on. Optional when exactly one account is connected.
`pageToken`	No
`bodyFormat`	No

Output Schema

Name	Required	Description	Default
`data`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 31, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "properties": {
+    "data": {
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "messages": {
+          "items": {
+            "additionalProperties": true,
+            "properties": {
+              "accountId": {
+                "type": "string"
+              },
+              "attachments": {
+                "items": {
+                  "additionalProperties": true,
+                  "properties": {
+                    "filename": {
+                      "type": "string"
+                    },
+                    "id": {
+                      "type": "string"
+                    },
+                    "mimeType": {
+                      "type": "string"
+                    },
+                    "sizeBytes": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "filename",
+                    "mimeType",
+                    "sizeBytes"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "body": {
+                "additionalProperties": false,
+                "properties": {
+                  "html": {
+                    "type": "string"
+                  },
+                  "text": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "bodyTruncation": {
+                "additionalProperties": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "nextOffset": {
+                      "type": "number"
+                    },
+                    "totalChars": {
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "totalChars"
+                  ],
+                  "type": "object"
+                },
+                "type": "object"
+              },
+              "date": {
+                "type": "string"
+              },
+              "flags": {
+                "additionalProperties": true,
+                "properties": {
+                  "draft": {
+                    "type": "boolean"
+                  },
+                  "read": {
+                    "type": "boolean"
+                  },
+                  "starred": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "read",
+                  "starred",
+                  "draft"
+                ],
+                "type": "object"
+              },
+              "id": {
+                "type": "string"
+              },
+              "subject": {
+                "type": "string"
+              },
+              "threadId": {
+                "type": "string"
+              },
+              "to": {
+                "items": {
+                  "additionalProperties": true,
+                  "properties": {
+                    "email": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "email"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "id",
+              "threadId",
+              "accountId",
+              "to",
+              "subject",
+              "date",
+              "flags"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "nextPageToken": {
+          "type": "string"
+        },
+        "subject": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "subject",
+        "messages"
+      ],
+      "type": "object"
+    }
+  },
+  "required": [
+    "data"
+  ],
+  "type": "object"
+}

Changed3 schema fields changedOct 29, 2026

changedInput schema / properties / accountId / anyOf

Previous value: -[
-  {
-    "minLength": 1,
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maxLength": 512,
+    "minLength": 1,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / pageToken / anyOf

Previous value: -[
-  {
-    "minLength": 1,
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "maxLength": 1024,
+    "minLength": 1,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / threadId / maxLength
```
Added value: +512
```

Changed18 schema fields changedOct 27, 2026

changedInput schema / $schema

Previous value: -"https://json-schema.org/draft/2020-12/schema"New value: +"http://json-schema.org/draft-07/schema#"

addedInput schema / properties / accountId / anyOf

Added value: +[
+  {
+    "minLength": 1,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / accountId / description

Added value: +"Account to operate on. Optional when exactly one account is connected."

removedInput schema / properties / accountId / maxLength
```
Removed value: -512
```
removedInput schema / properties / accountId / minLength
```
Removed value: -1
```
removedInput schema / properties / accountId / type
```
Removed value: -"string"
```

addedInput schema / properties / bodyFormat / anyOf

Added value: +[
+  {
+    "enum": [
+      "text",
+      "html",
+      "both",
+      "none"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / bodyFormat / enum

Removed value: -[
-  "text",
-  "html",
-  "both",
-  "none"
-]

removedInput schema / properties / bodyFormat / type
```
Removed value: -"string"
```

addedInput schema / properties / pageSize / anyOf

Added value: +[
+  {
+    "maximum": 25,
+    "minimum": 1,
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / pageSize / maximum
```
Removed value: -25
```
removedInput schema / properties / pageSize / minimum
```
Removed value: -1
```
removedInput schema / properties / pageSize / type
```
Removed value: -"integer"
```

addedInput schema / properties / pageToken / anyOf

Added value: +[
+  {
+    "minLength": 1,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / pageToken / maxLength
```
Removed value: -512
```
removedInput schema / properties / pageToken / minLength
```
Removed value: -1
```
removedInput schema / properties / pageToken / type
```
Removed value: -"string"
```
removedInput schema / properties / threadId / maxLength
```
Removed value: -512
```

Changed1 schema field changedOct 25, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Changed3 schema fields changedOct 23, 2026

addedInput schema / properties / bodyFormat

Added value: +{
+  "enum": [
+    "text",
+    "html",
+    "both",
+    "none"
+  ],
+  "type": "string"
+}

addedInput schema / properties / pageSize

Added value: +{
+  "maximum": 25,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / pageToken

Added value: +{
+  "maxLength": 512,
+  "minLength": 1,
+  "type": "string"
+}

First observedOct 15, 2026

TDQS

C2.9/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false, and openWorldHint=false, so safety is covered. The description adds one genuinely useful behavioral fact not present in structured fields: a 50,000 body-character cap per page, which warns of truncation. It omits how paging terminates, what the default body format is, and whether the cap applies per message or per response.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence with no filler; the size constraint is stated up front. It is efficient but so terse that the brevity starts to cost information rather than save it.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be described, but a paginated read tool with 5 parameters, 20% schema coverage, and an undocumented enum needs far more than one sentence. Missing pageSize defaults, pageToken usage, and bodyFormat effects leave an agent guessing on core invocation details.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 20% — accountId is documented in the schema, but pageSize, pageToken, and bodyFormat (an enum with four values) carry no descriptions. The description hints at pagination and body size but does not explain pageSize bounds, pageToken round-tripping, or the text/html/both/none semantics, so the gap is not compensated.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Specific verb+resource ("Read a page of messages in an email thread") that clearly separates it from siblings like get_email (single message) and list_emails (folder listing). It does not explicitly name an alternative, but the thread-scoped read is unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to choose this over get_email, get_email_body, or search_emails, nor on how to continue paging. The phrase "a page of" only implies that pagination exists; the agent must infer when and how to iterate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Fluxmail Cloud tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?