Skip to main content
Glama

Moltbound Sandbox

moltbound_purchase_status

Poll the status of a fictional purchase by purchase_id until 'bound'. Returns partner's policy_number. SANDBOX: use fictitious data only. Do not enter real personal details.

Input Schema

NameRequiredDescriptionDefault
purchase_idYes
session_tokenYesFrom moltbound_start_session or moltbound_human_sim_verify

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.2/5.0
Behavior3/5

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

No annotations are present, so the description carries the full burden. It does disclose the polling contract, the terminal state, the return field, and the sandbox restriction on data — useful context. It omits what happens on an invalid/expired purchase_id, whether polling is rate-limited, and what a non-terminal response looks like.

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?

Three tight sentences with the operation, exit condition, and return value front-loaded; the SANDBOX warning is short and earns its place. Minimal waste, though it could be denser by folding the return value into the first sentence.

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

Completeness3/5

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

With no output schema and no annotations, the description must do more, and it does state the key return field and the polling termination rule. It leaves error/empty-state behavior and the origin of purchase_id unaddressed, which matters for a two-required-parameter polling tool.

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 coverage is only 50%: session_token is documented in the schema, but purchase_id has no description anywhere. The prose merely restates 'by purchase_id' and does not say its format, where it comes from (e.g., quick_quote / get_quotes), or what to do if it is unknown, so the description fails to compensate for the gap.

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?

Names a specific verb+resource (poll the status of a purchase, keyed by purchase_id) and states the terminal condition ('bound') plus the payload returned (policy_number). That is enough to separate it from moltbound_quote_status / moltbound_grant_status / moltbound_poll_grant, though it never explicitly says so.

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?

'Poll ... until bound' implies the repeated-call pattern and its exit condition, which is genuine usage guidance. But there is no explicit statement of when to prefer it over the several sibling status tools, nor any prerequisite about how a purchase_id is obtained.

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.

Resources