Skip to main content
Glama

MyHumanRep: Contact a Human

Start a conversation with a human

start_conversation

Sends a pseudonymous first inquiry to a human reviewer. Returns conversation_id and conversation_token. The token is shown ONCE and cannot be recovered: store it. A reply is not guaranteed and nothing is executed automatically.

Input Schema

NameRequiredDescriptionDefault
intentNo
messageYesRequired. Your inquiry in your own words. Text only. Max 4000 characters and 10240 UTF-8 bytes.
subjectNo
languageNo
model_claimNo
sender_labelNo
claimed_autonomyNo
client_request_idNo
preferred_languageNo
previous_conversation_idNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / previous_conversation_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Optional. A conversation you started before and lost the token for. Stored as an unverified claim so a human can see both threads; it grants no access to the old thread.",
      +      "pattern": "^conv_[A-Za-z0-9_-]{22}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
  2. First observed

TDQS

A3.7/5.0
Behavior5/5

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

Goes well beyond the annotations by disclosing the one-time, non-recoverable conversation_token and the obligation to store it, plus that a reply is not guaranteed and nothing is executed automatically. These are exactly the operational facts an agent needs and none of them are available from readOnlyHint/openWorldHint/idempotentHint.

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?

Three short sentences, no filler, and the highest-risk fact (one-time token that cannot be recovered) is placed early and emphasized. Every sentence carries distinct information.

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?

Return values are covered in the description, which is needed since there is no output schema, and the non-guaranteed reply is disclosed. However, for a 10-parameter open-world creation tool, the absence of any input-side guidance and of the duplicate-handling behavior leaves a real gap.

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 only 10% across 10 parameters, so the description carries the burden and largely does not: it never mentions message, intent, sender_label, language, previous_conversation_id, or the client_request_id deduplication contract. It only implies the shape of the return values (conversation_id, conversation_token), leaving most input semantics undocumented.

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 and resource ('Sends a pseudonymous first inquiry to a human reviewer'), and the word 'first' implicitly separates it from continue_conversation and send_message. It never names those siblings explicitly, so the differentiation is inferred rather than stated.

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?

Usage is only implied by 'first inquiry' and 'a human reviewer'; there is no explicit when-to-use or when-not-to-use guidance and no routing against siblings such as request_human_dialogue, describe_human_need, or request_human_representative. An agent must infer that this is the entry point before any conversation exists.

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