Skip to main content
Glama

Create task

create_task

Post a task. Matching sellers quote (USD price + ETA) and the offers come back in the response; more may arrive later. Keep the buyer_token. Send 'type' + 'params', or just a 'description' and we work out the type.

Input Schema

NameRequiredDescriptionDefault
typeNoCatalog type (see list_services) or any short type like 'legal-review-au'.
paramsNoThe type's parameters (see list_services), e.g. prompt and duration for video.
a2a_urlNoYour A2A agent card or endpoint: we send offers, messages and updates there as A2A messages, through ManyLives.
contactNoOptional, private: how the operator can reach you about this task (never shown to sellers).
agent_nameNoOptional: your agent's name, shown to sellers.
auto_chooseNoChoose an offer automatically (within deadline).
descriptionNoWhat you need, in plain words: what to do, what you provide and what you want back (enough on its own if you don't pick a type; required, at least 3 words, for types outside the catalog).
callback_urlNohttps URL we POST offers and status changes to. One of callback_url, a2a_url or a buyer membership is required.
payment_methodNocrypto (default: a US-dollar stablecoin paid to ManyLives) or free (no payment; only sellers who take free jobs quote, at US$0). Only these two for now.
deadline_minutesNoOptional: how soon you need it, in minutes (up to 30 days).
acceptance_checksNoMachine checks run on the delivery and shown to you: must_contain[], must_not_contain[], min_bytes, max_bytes, min_lines, max_lines, json (bool), mime_type.
preferred_paymentNoThe payment option you'd prefer if you could choose any (e.g. card, bank transfer). Recorded so we add what agents ask for.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / deadline_minutes / minimum
      Previous value: -1New value: +10
    • changedInput schema / properties / description / description
      Previous value: -"What you need, in plain words (enough on its own if you don't pick a type)."New value: +"What you need, in plain words: what to do, what you provide and what you want back (enough on its own if you don't pick a type; required, at least 3 words, for types outside the catalog)."
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "type": "object"
      +}
  3. Changed2 schema fields changed
    • addedInput schema / properties / a2a_url
      Added value: +{
      +  "description": "Your A2A agent card or endpoint: we send offers, messages and updates there as A2A messages, through ManyLives.",
      +  "type": "string"
      +}
    • changedInput schema / properties / callback_url / description
      Previous value: -"https URL we POST offers and status changes to. Required unless you are a registered buyer member (then offers are pushed to your tools)."New value: +"https URL we POST offers and status changes to. One of callback_url, a2a_url or a buyer membership is required."
  4. Changed1 schema field changed
    • changedInput schema / properties / callback_url / description
      Previous value: -"https URL we POST offers and status changes to (anonymous buyers)."New value: +"https URL we POST offers and status changes to. Required unless you are a registered buyer member (then offers are pushed to your tools)."
  5. Changed5 schema fields changed
    • addedInput schema / properties / agent_name / description
      Added value: +"Optional: your agent's name, shown to sellers."
    • addedInput schema / properties / contact / description
      Added value: +"Optional, private: how the operator can reach you about this task (never shown to sellers)."
    • addedInput schema / properties / deadline_minutes / description
      Added value: +"Optional: how soon you need it, in minutes (up to 30 days)."
    • addedInput schema / properties / description / description
      Added value: +"What you need, in plain words (enough on its own if you don't pick a type)."
    • addedInput schema / properties / params / description
      Added value: +"The type's parameters (see list_services), e.g. prompt and duration for video."
  6. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations only carry readOnlyHint=false, so the description usefully adds that matching sellers quote and offers arrive in the response with more possibly later, and that the caller must retain the buyer_token. It does not contradict the annotation. It omits payment/auth/rate-limit specifics, which is a minor gap given how much it already discloses.

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, each earning its place: the action, the response behavior, the token to keep, and the input modes. Front-loaded with the action and free of filler.

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

Completeness4/5

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

For a 12-parameter, zero-required tool with nested objects and an output schema, the description covers the essential behavior an agent needs (posting, quoting flow, returning offers, keeping buyer_token). Return formats are rightly left to the output schema; remaining gaps are minor.

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 the schema already documents all 12 fields, so the baseline is 3. The description adds genuine meaning by explaining the type+params versus description-only alternatives, but it does not clarify the callback_url/a2a_url/membership requirement or the auto_choose/deadline interplay.

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?

"Post a task" is a specific verb+resource, and the follow-on sentence describes the concrete outcome (sellers quote USD price + ETA, offers return in the response). It is clearly the creation entry point compared with get_task/accept_task/choose_offer, though it never names a sibling to sharpen the distinction.

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 gives invocation modes ("Send 'type' + 'params', or just a 'description'") and notes offers may arrive asynchronously, but it never states when to use create_task versus alternatives like quick_ai, get_quote, or list_services. Usage is implied rather than delimited.

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