Skip to main content
Glama

Human Do

human_do

Create a task for a human oracle to complete in the real world. Requires x402 payment. Returns a task_id to poll with task_status.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
intentYesWhat you want the human to do
proof_typeYesType of proof
instructionsYesDetailed instructions for the human
service_tierNointegration_test
target_locationNoOptional target location and allowed capture radius
timeout_secondsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / service_tier / enum
      Previous value: -[
      -  "integration_test",
      -  "quick_check",
      -  "photo_visit",
      -  "urgent_visit",
      -  "complex_visit"
      -]New value: +[
      +  "integration_test",
      +  "evaluation_test",
      +  "quick_check",
      +  "photo_visit",
      +  "urgent_visit",
      +  "complex_visit"
      +]
  2. Changed2 schema fields changed
    • changedInput schema / properties / service_tier / default
      Previous value: -"quick_check"New value: +"integration_test"
    • changedInput schema / properties / service_tier / enum
      Previous value: -[
      -  "quick_check",
      -  "photo_visit",
      -  "urgent_visit",
      -  "complex_visit"
      -]New value: +[
      +  "integration_test",
      +  "quick_check",
      +  "photo_visit",
      +  "urgent_visit",
      +  "complex_visit"
      +]
  3. Changed2 schema fields changed
    • removedInput schema / properties / budget_usdt
      Removed value: -{
      -  "default": "0.01",
      -  "pattern": "^\\d+(\\.\\d{1,6})?$",
      -  "type": "string"
      -}
    • addedInput schema / properties / service_tier
      Added value: +{
      +  "default": "quick_check",
      +  "enum": [
      +    "quick_check",
      +    "photo_visit",
      +    "urgent_visit",
      +    "complex_visit"
      +  ],
      +  "type": "string"
      +}
  4. First observed

TDQS

B3.3/5.0
Behavior3/5

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

With zero annotations, the description carries the full behavioral burden. It does add meaningful context: x402 payment is required, and the operation returns only a task_id for later polling rather than a synchronous result. It does not disclose failure modes, cost behavior, side effects, or what happens if payment fails, which is notable for a paid task-creation tool.

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 short sentences that front-load the purpose first, followed by the two essential operational facts (payment requirement, task_id polling). Every sentence earns its place and there is no filler, though the unusual 'human oracle' phrasing is a minor clarity blemish.

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?

Given the complexity — 6 parameters, a nested target_location object, a payment requirement, an async flow, no annotations, and no output schema — the description is too thin. It covers the create→pay→poll loop but omits operational context such as proof-type implications, service-tier selection, cost expectations, and failure handling, which an agent needs to invoke this tool correctly.

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 description coverage is 67%, which is mid-range, so the baseline is 3. The description adds no parameter-level meaning — it says nothing about proof_type (photo vs. form), service_tier options, target_location, or timeout_seconds, the last two of which are undocumented in the schema. The schema's mid-range coverage carries the weight here.

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?

The description uses a specific verb ('Create') with a clear resource ('a task for a human oracle to complete in the real world'), making the core purpose unambiguous. It explicitly names the sibling task_status as the polling tool, which provides some differentiation, though it doesn't distinguish itself from ground_truth_info or review_task.

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 usage context — when a real-world human action is needed — and discloses the x402 payment prerequisite and the follow-up polling pattern with task_status. However, it gives no when-not-to-use guidance, exclusion criteria, or comparison against the sibling tools, so usage selection is left largely to inference.

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.