Skip to main content
Glama

Take over and notify contact

inbox_takeover
DestructiveIdempotent

Takes reply ownership AND announces to contact using the existing deterministic identity.

Conversation/messages expose uncertain outcomes; a new takeover is not a harmless read.

Input Schema

NameRequiredDescriptionDefault
agent_idYesAgent ID from agents_list or agent_create.
conversation_idYesConversation ID from inbox_list or conversations_search.

Output Schema

NameRequiredDescriptionDefault
statusYes
operation_idYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / agent_id / description
      Added value: +"Agent ID from agents_list or agent_create."
    • addedInput schema / properties / conversation_id / description
      Added value: +"Conversation ID from inbox_list or conversations_search."
  2. First observed

TDQS

B3.4/5.0
Behavior4/5

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

Annotations already declare destructiveHint=true, idempotentHint=true, and openWorldHint=true, so the safety profile is structured. The description still adds real value beyond that: it discloses that a message is actually sent to the contact ('announces to contact'), that an existing deterministic identity is reused, and that outcomes may be uncertain.

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?

Two short sentences with the action front-loaded and the caution appended. Slightly cryptic phrasing ('existing deterministic identity', 'Conversation/messages expose uncertain outcomes') costs a bit of clarity but nothing is padded.

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?

An output schema exists so return values need no explanation, but for a destructive, externally-visible mutation the description omits what the takeover actually changes (ownership transfer scope), whether it is reversible via inbox_return_to_ai, and which channel the announcement traverses.

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

Parameters3/5

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

Schema coverage is 100% and both uuid parameters are documented at the schema level (agent_id from agents_list/agent_create, conversation_id from inbox_list/conversations_search). The description adds no additional parameter meaning, so the baseline of 3 applies.

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?

States a specific verb pair and resource: taking reply ownership and announcing to the contact. An agent can tell this apart from inbox_reply or inbox_message_reconcile in spirit, though no sibling is named explicitly.

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?

It warns that 'a new takeover is not a harmless read' but never says when to choose this over inbox_return_to_ai, inbox_resolve, or inbox_reply, which are the obvious alternatives in a crowded inbox_* family. No prerequisites or exclusion conditions are given.

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