Skip to main content
Glama

inbox_create

Create a receive-only email inbox (temporary or permanent) on the configured inbound domain.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
kindYes
domainNo
localPartYes
ttlSecondsNo

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Added

TDQS

B3.3/5.0
Behavior2/5

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

No annotations exist, so the description must carry the full behavioral disclosure burden. It only mentions 'receive-only' and 'temporary or permanent', which are more about purpose than side effects. It does not disclose expiration behavior for temporary inboxes, whether ttlSeconds is enforced, permissions needed, or what happens if the localPart already exists.

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

Conciseness5/5

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

One short sentence with no filler or redundancy. It front-loads the action and resource, and every word adds meaning.

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?

With 4 parameters, 0% schema coverage, no output schema, and no annotations, the description is too thin for safe invocation. It omits what localPart means, how TTL applies to temporary inboxes, and what the created inbox response looks like. The sibling set clarifies the action type but not the full call contract.

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 0%, so the description needs to compensate. It maps to 'kind' via temporary/permanent and hints at 'domain' with 'configured inbound domain', but the required 'localPart' and the optional 'ttlSeconds' are completely unexplained, leaving an agent without enough meaning to construct valid arguments confidently.

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?

States a specific verb (create), a concrete resource (receive-only email inbox), and key qualifiers (temporary or permanent, on the configured inbound domain). This is clearly distinct from sibling tools like inbox_get, inbox_list, and inbox_delete, which perform different operations on inboxes.

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

Usage Guidelines3/5

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

The description implies the tool is for creating a new inbox, but it gives no explicit guidance about when to use this versus alternatives, such as inbox_webhook_create. No exclusions or conditions are stated, though the unique 'create inbox' purpose makes the intended context inferable.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

B3.2/5.0
Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness3/5

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.