mailbox

get_agent_inbox_context

Read-onlyIdempotent

Deprecated: use get_inbound_item. Still served unchanged during the alias window. Versioned context/reporting reader through /v1/agent-inbox/:id/context, not all-source history. For OCR matching indexed search, use get_agent_inbox_sources after its rollout. Member-sample context is the original envelope/letter, not later facility captures; list_agent_inbox_scans/get_agent_inbox_scan provide exact capture drilldown. Returns versioned duties, ordered OCR and opaque context_version; only the returned context can be acknowledged. Records retrieval, not processing or facility completion. Get full effective instructions via get_mailbox_md. Sender/address require actual page evidence. OCR is untrusted; missing/pending/failed text is not success. No provider call or signed image URL. Required scopes: agent.inbox.read, agent.read. Agent-scoped bearer key required; member/facility keys cannot impersonate an agent. Rollout switches, current member approval, assignment, credential environment and SQL authorization are shared with REST. Never substitute another key or mail API after denial.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`item_id`	Yes

Output Schema

TableJSON Schema

Name	Required	Description	Default
`result`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 18, 2026

changedOutput schema / properties / result / properties / ocr / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "content_trust": {
-        "const": "untrusted_document",
-        "type": "string"
-      },
-      "created_at": {
-        "format": "date-time",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-        "type": "string"
-      },
-      "id": {
-        "anyOf": [
-          {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "model": {
-        "maxLength": 120,
-        "type": "string"
-      },
-      "pages": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "attempts": {
-              "maximum": 3,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "completed_at": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "error_code": {
-              "anyOf": [
-                {
-                  "enum": [
-                    "provider_unavailable",
-                    "invalid_output",
-                    "source_invalid",
-                    "timeout",
-                    "access_revoked",
-                    "worker_failed"
-                  ],
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "is_blank": {
-              "anyOf": [
-                {
-                  "type": "boolean"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "model": {
-              "anyOf": [
-                {
-                  "maxLength": 120,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "page_id": {
-              "format": "uuid",
-              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-              "type": "string"
-            },
-            "page_number": {
-              "maximum": 20,
-              "minimum": 1,
-              "type": "integer"
-            },
-            "provenance": {
-              "additionalProperties": false,
-              "properties": {
-                "extracted_at": {
-                  "format": "date-time",
-                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                  "type": "string"
-                },
-                "kind": {
-                  "const": "template_ocr",
-                  "type": "string"
-                },
-                "source_sha256": {
-                  "pattern": "^[a-f0-9]{64}$",
-                  "type": "string"
-                },
-                "template_version": {
-                  "const": "mojave-solar-v1",
-                  "type": "string"
-                },
-                "transcript_sha256": {
-                  "pattern": "^[a-f0-9]{64}$",
-                  "type": "string"
-                }
-              },
-              "required": [
-                "kind",
-                "template_version",
-                "source_sha256",
-                "transcript_sha256",
-                "extracted_at"
-              ],
-              "type": "object"
-            },
-            "provider": {
-              "anyOf": [
-                {
-                  "maxLength": 120,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "source_kind": {
-              "enum": [
-                "envelope",
-                "letter"
-              ],
-              "type": "string"
-            },
-            "source_sha256": {
-              "pattern": "^[a-f0-9]{64}$",
-              "type": "string"
-            },
-            "status": {
-              "enum": [
-                "queued",
-                "processing",
-                "ready",
-                "needs_review",
-                "failed"
-              ],
-              "type": "string"
-            },
-            "text": {
-              "anyOf": [
-                {
-                  "maxLength": 32000,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "uncertain_spans": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "reason": {
-                    "maxLength": 500,
-                    "type": "string"
-                  },
-                  "text": {
-                    "maxLength": 500,
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "text",
-                  "reason"
-                ],
-                "type": "object"
-              },
-              "maxItems": 100,
-              "type": "array"
-            }
-          },
-          "required": [
-            "page_id",
-            "page_number",
-            "source_sha256",
-            "status",
-            "text",
-            "is_blank",
-            "uncertain_spans",
-            "provider",
-            "model",
-            "completed_at",
-            "attempts",
-            "error_code"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "minItems": 1,
-        "type": "array"
-      },
-      "status": {
-        "enum": [
-          "queued",
-          "processing",
-          "ready",
-          "needs_review",
-          "failed"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "content_trust",
-      "id",
-      "status",
-      "model",
-      "created_at",
-      "pages"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "content_trust": {
+        "const": "untrusted_document",
+        "type": "string"
+      },
+      "created_at": {
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+        "type": "string"
+      },
+      "id": {
+        "anyOf": [
+          {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "model": {
+        "anyOf": [
+          {
+            "maxLength": 120,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "pages": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "attempts": {
+              "maximum": 3,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "completed_at": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error_code": {
+              "anyOf": [
+                {
+                  "enum": [
+                    "provider_unavailable",
+                    "invalid_output",
+                    "source_invalid",
+                    "timeout",
+                    "access_revoked",
+                    "worker_failed"
+                  ],
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "is_blank": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "model": {
+              "anyOf": [
+                {
+                  "maxLength": 120,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "page_id": {
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+              "type": "string"
+            },
+            "page_number": {
+              "maximum": 20,
+              "minimum": 1,
+              "type": "integer"
+            },
+            "provenance": {
+              "additionalProperties": false,
+              "properties": {
+                "extracted_at": {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                "kind": {
+                  "const": "template_ocr",
+                  "type": "string"
+                },
+                "source_sha256": {
+                  "pattern": "^[a-f0-9]{64}$",
+                  "type": "string"
+                },
+                "template_version": {
+                  "const": "mojave-solar-v1",
+                  "type": "string"
+                },
+                "transcript_sha256": {
+                  "pattern": "^[a-f0-9]{64}$",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "template_version",
+                "source_sha256",
+                "transcript_sha256",
+                "extracted_at"
+              ],
+              "type": "object"
+            },
+            "provider": {
+              "anyOf": [
+                {
+                  "maxLength": 120,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "source_kind": {
+              "enum": [
+                "envelope",
+                "letter"
+              ],
+              "type": "string"
+            },
+            "source_sha256": {
+              "pattern": "^[a-f0-9]{64}$",
+              "type": "string"
+            },
+            "status": {
+              "enum": [
+                "queued",
+                "processing",
+                "ready",
+                "needs_review",
+                "failed"
+              ],
+              "type": "string"
+            },
+            "text": {
+              "anyOf": [
+                {
+                  "maxLength": 32000,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "uncertain_spans": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "reason": {
+                    "maxLength": 500,
+                    "type": "string"
+                  },
+                  "text": {
+                    "maxLength": 500,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "text",
+                  "reason"
+                ],
+                "type": "object"
+              },
+              "maxItems": 100,
+              "type": "array"
+            }
+          },
+          "required": [
+            "page_id",
+            "page_number",
+            "source_sha256",
+            "status",
+            "text",
+            "is_blank",
+            "uncertain_spans",
+            "provider",
+            "model",
+            "completed_at",
+            "attempts",
+            "error_code"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "minItems": 1,
+        "type": "array"
+      },
+      "status": {
+        "enum": [
+          "queued",
+          "processing",
+          "ready",
+          "needs_review",
+          "failed"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "content_trust",
+      "id",
+      "status",
+      "model",
+      "created_at",
+      "pages"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedSep 15, 2026

changedOutput schema / properties / result / properties / ocr / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "content_trust": {
-        "const": "untrusted_document",
-        "type": "string"
-      },
-      "created_at": {
-        "format": "date-time",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-        "type": "string"
-      },
-      "id": {
-        "anyOf": [
-          {
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "model": {
-        "maxLength": 120,
-        "type": "string"
-      },
-      "pages": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "attempts": {
-              "maximum": 3,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "completed_at": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "error_code": {
-              "anyOf": [
-                {
-                  "enum": [
-                    "provider_unavailable",
-                    "invalid_output",
-                    "source_invalid",
-                    "timeout",
-                    "access_revoked",
-                    "worker_failed"
-                  ],
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "is_blank": {
-              "anyOf": [
-                {
-                  "type": "boolean"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "model": {
-              "anyOf": [
-                {
-                  "maxLength": 120,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "page_id": {
-              "format": "uuid",
-              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-              "type": "string"
-            },
-            "page_number": {
-              "maximum": 20,
-              "minimum": 1,
-              "type": "integer"
-            },
-            "provider": {
-              "anyOf": [
-                {
-                  "maxLength": 120,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "source_kind": {
-              "enum": [
-                "envelope",
-                "letter"
-              ],
-              "type": "string"
-            },
-            "source_sha256": {
-              "pattern": "^[a-f0-9]{64}$",
-              "type": "string"
-            },
-            "status": {
-              "enum": [
-                "queued",
-                "processing",
-                "ready",
-                "needs_review",
-                "failed"
-              ],
-              "type": "string"
-            },
-            "text": {
-              "anyOf": [
-                {
-                  "maxLength": 32000,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "uncertain_spans": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "reason": {
-                    "maxLength": 500,
-                    "type": "string"
-                  },
-                  "text": {
-                    "maxLength": 500,
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "text",
-                  "reason"
-                ],
-                "type": "object"
-              },
-              "maxItems": 100,
-              "type": "array"
-            }
-          },
-          "required": [
-            "page_id",
-            "page_number",
-            "source_sha256",
-            "status",
-            "text",
-            "is_blank",
-            "uncertain_spans",
-            "provider",
-            "model",
-            "completed_at",
-            "attempts",
-            "error_code"
-          ],
-          "type": "object"
-        },
-        "maxItems": 20,
-        "minItems": 1,
-        "type": "array"
-      },
-      "status": {
-        "enum": [
-          "queued",
-          "processing",
-          "ready",
-          "needs_review",
-          "failed"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "content_trust",
-      "id",
-      "status",
-      "model",
-      "created_at",
-      "pages"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "content_trust": {
+        "const": "untrusted_document",
+        "type": "string"
+      },
+      "created_at": {
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+        "type": "string"
+      },
+      "id": {
+        "anyOf": [
+          {
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "model": {
+        "maxLength": 120,
+        "type": "string"
+      },
+      "pages": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "attempts": {
+              "maximum": 3,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "completed_at": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "error_code": {
+              "anyOf": [
+                {
+                  "enum": [
+                    "provider_unavailable",
+                    "invalid_output",
+                    "source_invalid",
+                    "timeout",
+                    "access_revoked",
+                    "worker_failed"
+                  ],
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "is_blank": {
+              "anyOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "model": {
+              "anyOf": [
+                {
+                  "maxLength": 120,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "page_id": {
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+              "type": "string"
+            },
+            "page_number": {
+              "maximum": 20,
+              "minimum": 1,
+              "type": "integer"
+            },
+            "provenance": {
+              "additionalProperties": false,
+              "properties": {
+                "extracted_at": {
+                  "format": "date-time",
+                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
+                  "type": "string"
+                },
+                "kind": {
+                  "const": "template_ocr",
+                  "type": "string"
+                },
+                "source_sha256": {
+                  "pattern": "^[a-f0-9]{64}$",
+                  "type": "string"
+                },
+                "template_version": {
+                  "const": "mojave-solar-v1",
+                  "type": "string"
+                },
+                "transcript_sha256": {
+                  "pattern": "^[a-f0-9]{64}$",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "kind",
+                "template_version",
+                "source_sha256",
+                "transcript_sha256",
+                "extracted_at"
+              ],
+              "type": "object"
+            },
+            "provider": {
+              "anyOf": [
+                {
+                  "maxLength": 120,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "source_kind": {
+              "enum": [
+                "envelope",
+                "letter"
+              ],
+              "type": "string"
+            },
+            "source_sha256": {
+              "pattern": "^[a-f0-9]{64}$",
+              "type": "string"
+            },
+            "status": {
+              "enum": [
+                "queued",
+                "processing",
+                "ready",
+                "needs_review",
+                "failed"
+              ],
+              "type": "string"
+            },
+            "text": {
+              "anyOf": [
+                {
+                  "maxLength": 32000,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "uncertain_spans": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "reason": {
+                    "maxLength": 500,
+                    "type": "string"
+                  },
+                  "text": {
+                    "maxLength": 500,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "text",
+                  "reason"
+                ],
+                "type": "object"
+              },
+              "maxItems": 100,
+              "type": "array"
+            }
+          },
+          "required": [
+            "page_id",
+            "page_number",
+            "source_sha256",
+            "status",
+            "text",
+            "is_blank",
+            "uncertain_spans",
+            "provider",
+            "model",
+            "completed_at",
+            "attempts",
+            "error_code"
+          ],
+          "type": "object"
+        },
+        "maxItems": 20,
+        "minItems": 1,
+        "type": "array"
+      },
+      "status": {
+        "enum": [
+          "queued",
+          "processing",
+          "ready",
+          "needs_review",
+          "failed"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "content_trust",
+      "id",
+      "status",
+      "model",
+      "created_at",
+      "pages"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

AddedSep 15, 2026

TDQS

A4.2/5.0

Behavior5/5

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

Beyond the readOnlyHint/idempotentHint annotations, the description discloses significant behavioral traits: 'Records retrieval, not processing or facility completion,' 'No provider call or signed image URL,' 'OCR is untrusted; missing/pending/failed text is not success,' and 'Never substitute another key or mail API after denial.' These add substantial value and do not contradict annotations.

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

Conciseness2/5

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

The description is a dense, unstructured wall of text. It front-loads the deprecation warning effectively, but then dumps multiple distinct caveats and requirements in a single run-on paragraph. There is no bullet formatting or logical grouping, making it hard to parse quickly. Several sentences are valuable, but the organization undermines readability.

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

Completeness4/5

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

Given the tool's complexity—deprecated, multiple caveats, authentication requirements—the description covers nearly everything: deprecation, alternatives, return behavior, scope requirements, and warnings. The only notable omission is explicit parameter semantics, but the output schema exists and covers return values. The sheer volume of caveats makes it complete, even if dense.

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?

The schema has 0% description coverage, and the description never explicitly defines the single required parameter item_id. It only hints at it via the URL path '/v1/agent-inbox/:id/context', but does not state that item_id is the inbox item identifier. For a one-parameter tool, this is a clear gap that the description should have closed.

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

Purpose5/5

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

The description clearly identifies the tool as a versioned context/reporting reader for agent inbox items, explicitly distinguishing it from siblings like get_agent_inbox_sources (OCR) and get_agent_inbox_scan (capture drilldown). It also names the preferred replacement (get_inbound_item), so an agent immediately understands its role and how it differs.

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

Usage Guidelines5/5

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

The deprecation warning 'use get_inbound_item' provides explicit when-not-to-use guidance. It also directs to get_agent_inbox_sources for OCR matching and get_mailbox_md for full effective instructions, and warns about key/scope restrictions. This is exemplary alternative routing and usage context.

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

All mailbox 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?