inbox_get
Get one inbox by id.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inboxId | Yes |
Get one inbox by id.
| Name | Required | Description | Default |
|---|---|---|---|
| inboxId | Yes |
Changes observed during successful MCP inspections. Dates show when Glama detected each change.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description carries the full burden. 'Get' implies a read operation, and the wording is consistent with a non-destructive fetch. However, there is no explicit statement of read-only behavior, what happens if the inbox does not exist, or any details about the response shape. For a simple get tool this is acceptable but not transparent beyond the obvious.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one tight sentence with no filler or redundant information. The essential action ('Get'), object ('one inbox'), and input criterion ('by id') are all present and front-loaded. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter read tool with no output schema, the description tells the agent what it does and what input it needs. It does not spell out the return value, but 'get one inbox' implies the inbox object is returned. The description is sufficiently complete for an agent to invoke the tool correctly, though it leaves a little to inference.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. It mentions 'by id', which clearly maps to the single inboxId parameter, but it does not explain that the ID is required or provide any format details. Given only one parameter named inboxId, the minimal description is adequate but adds little beyond the parameter name.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: 'Get one inbox by id.' This clearly distinguishes it from siblings like inbox_list (which returns multiple) and inbox_message_get (which targets messages). The agent can confidently select this tool for retrieving a single inbox.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'by id' provides a clear usage condition: call this when you have the inbox identifier and need a single inbox. It does not explicitly mention alternatives or when not to use it, but the context is strong enough to avoid confusion with inbox_list or inbox_create.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
Most tools are named as resource+action and target distinct surfaces (inbox, kvp, files, billing), so an agent can generally select the right tool. A few pairs like budget_get vs usage_get and inbox_message_get vs inbox_message_raw have adjacent purposes, but their descriptions mostly clear up the boundary.
The predominant convention is snake_case noun_verb, e.g. kvp_get, inbox_create, files_list. Minor deviations like inspect_storage (verb-noun) and bare noun names such as billing_portal and files_types slightly break the pattern.
With 35 tools, the server is well above the 25+ threshold and bundles many subdomains—billing, KVP, inbox, RAG, files, keys, support—into one surface. It would be more coherent as separate servers or with a significantly trimmed inbox tool set.
Core workflows are mostly covered: inbox lifecycle, webhooks, KVP CRUD, billing, and usage are solid. However file upload has no corresponding delete/remove tool, and keys have create but no list/revoke, leaving noticeable lifecycle gaps.