Skip to main content
Glama

Agent Deal Brief: 60-Second Micro Offer Rubric

deal-brief
Read-onlyIdempotent

Return a 60-second go/no-go checklist and rubric for any micro side-income offer. Use when a human-readable checklist is enough and no specific offer needs analysing. Not for scanning a specific offer for scam evidence (use red-flag-scan) or scoring/ranking offers (use offer-score). Pick this when the question is 'what should I check?'. Returns a free sample plus the paid URL and pay steps (no charge here); the full result costs $0.75 Base USDC via x402.

Input Schema

NameRequiredDescriptionDefault
queryNoInput for the paid endpoint: offer text (optional).

Output Schema

NameRequiredDescriptionDefault
skuYes
noteNo
payToNo
priceNo
methodNo
networkNo
paid_urlYes
how_to_payYes
teaser_urlNo
your_inputNo
free_teaserNoFree sample output of this SKU (truncated); null if unavailable.
ready_requestNoExact paid HTTP request (method, url with your input, optional json_body) to send with an x402 client.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / ready_request
      Added value: +{
      +  "description": "Exact paid HTTP request (method, url with your input, optional json_body) to send with an x402 client."
      +}
  2. Changed1 schema field changed
    • addedOutput schema / properties / free_teaser
      Added value: +{
      +  "description": "Free sample output of this SKU (truncated); null if unavailable."
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / query / description
      Previous value: -"Optional input (e.g. url / address / text) to pass to the paid endpoint as ?q= or JSON body."New value: +"Input for the paid endpoint: offer text (optional)."
  4. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "how_to_pay": {
      +      "type": "string"
      +    },
      +    "method": {
      +      "type": "string"
      +    },
      +    "network": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "note": {
      +      "type": "string"
      +    },
      +    "paid_url": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "payTo": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "price": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "sku": {
      +      "type": "string"
      +    },
      +    "teaser_url": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "your_input": {}
      +  },
      +  "required": [
      +    "sku",
      +    "paid_url",
      +    "how_to_pay"
      +  ],
      +  "type": "object"
      +}
  5. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), but the description adds genuinely non-structured behavioral context: a free sample is returned plus the paid URL and pay steps, there is no charge for this call, and the full result costs $0.75 Base USDC via x402. That payment/entitlement disclosure is the kind of thing annotations cannot express; it stops short of a 5 only because it says nothing about latency or rate behavior.

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?

Five tightly packed sentences: purpose first, then use-when, then use-instead, then a plain-language selector ('what should I check?'), then pricing. Every sentence carries routing or cost information with no 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?

With an output schema present, return-shape detail is rightly omitted, and the routing plus payment model is covered. The only thin spot is the optional 'query' input, whose role in the paid flow is left entirely to the schema; everything an agent needs to decide and invoke is otherwise present.

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?

Only one parameter ('query', optional) exists and schema description coverage is 100%, so the schema already documents it as 'offer text (optional)'. The description never mentions the parameter or clarifies that it can be omitted entirely for a generic rubric, so it adds no semantics beyond the schema — the baseline 3 for high coverage is correct.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a concrete verb and deliverable ('Return a 60-second go/no-go checklist and rubric') scoped to 'micro side-income offer'. It explicitly names the siblings it is not (red-flag-scan, offer-score) and frames the selecting question, so an agent can distinguish it from adjacent tools without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives both the positive condition ('when a human-readable checklist is enough and no specific offer needs analysing', 'what should I check?') and the exclusions with named alternatives for each ('Not for scanning a specific offer for scam evidence (use red-flag-scan) or scoring/ranking offers (use offer-score)'). Nothing is left 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.

Resources