Skip to main content
Glama

Day Pass activate

day_pass_activate
Destructive

Agent-native access activation endpoint. Accepts an optional payment envelope or existing access key and returns a payment challenge or verified activation result. Activation results include receipt URL, run ID, access key, expiration, usage guidance, and a spend receipt. Activation occurs only after a verified transfer. AER-1 receipt, verifiable offline.

Input Schema

NameRequiredDescriptionDefault
_refNoOptional handover referral ID from your install link.
sponsorNoExplicitly sponsor another team's closed workflow; branding ownership never transfers.
x_paymentNoBase64 JSON x402 payment envelope recorded from the live challenge, sent as X-Payment.
_zambo_keyNoOptional opaque Zambo access capability. Never place it in a URL or public log.
session_idNoAlias for _session_id.
_session_idNoOptional stable bot-job ID. Reuse it across calls to bind a Day Pass and keep the job ledger together.
workflow_idNoOptional workflow to save with proof after verified payment.
_caller_labelNoOptional caller label recorded as a caller-reported claim in the receipt.zambo-starter
_caller_handleNoOpaque anonymous continuity handle returned during initialize. Reuse it across MCP sessions; it is not payment authorization.
_continuity_ai_labelNoOptional self-reported AI client label for the private continuity timeline. Zambo does not independently verify the client.

Output Schema

NameRequiredDescriptionDefault
okYes
idsYes
nextYes
tierNo
urlsYes
errorNo
graphNo
activeNo
resultYesThe tool's observed JSON value or plain-text result.
intentsNo
next_upNo
paymentNo
day_passNo
today_urlNo
expires_atNo
human_lineYes
next_stepsNo
daily_recapNo
renew_nudgeNo
unlock_linkNo
seconds_leftNo
resume_statusNo
resumed_resultNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / human_line / maxLength
      Previous value: -200New value: +512
  2. Changed1 schema field changed
    • changedInput schema / properties / workflow_id / description
      Previous value: -"Optional workflow to seal after verified payment."New value: +"Optional workflow to save with proof after verified payment."
  3. Changed2 schema fields changed
    • addedInput schema / properties / _caller_handle
      Added value: +{
      +  "description": "Opaque anonymous continuity handle returned during initialize. Reuse it across MCP sessions; it is not payment authorization.",
      +  "maxLength": 64,
      +  "type": "string"
      +}
    • addedInput schema / properties / _caller_label / default
      Added value: +"zambo-starter"
  4. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-25"New value: +"draft-zambo-aer1-26"
  5. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-24"New value: +"draft-zambo-aer1-25"
  6. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-23"New value: +"draft-zambo-aer1-24"
  7. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-22"New value: +"draft-zambo-aer1-23"
  8. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-21"New value: +"draft-zambo-aer1-22"
  9. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-20"New value: +"draft-zambo-aer1-21"
  10. Changed1 schema field changed
    • addedOutput schema / properties / next_steps
      Added value: +{
      +  "items": {},
      +  "minItems": 1,
      +  "type": "array"
      +}
  11. Changed1 schema field changed
    • changedInput schema / properties / x_payment / description
      Previous value: -"Base64 JSON x402 payment envelope wallet-authorized from the live challenge, sent as X-Payment."New value: +"Base64 JSON x402 payment envelope recorded from the live challenge, sent as X-Payment."
  12. Changed12 schema fields changed
    • addedInput schema / properties / _ref
      Added value: +{
      +  "description": "Optional handover referral ID from your install link.",
      +  "format": "uuid",
      +  "type": "string"
      +}
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +true
    • addedOutput schema / properties / error
      Added value: +{
      +  "additionalProperties": true,
      +  "anyOf": [
      +    {
      +      "required": [
      +        "next_call"
      +      ]
      +    },
      +    {
      +      "required": [
      +        "next_url"
      +      ]
      +    }
      +  ],
      +  "properties": {
      +    "code": {
      +      "type": "string"
      +    },
      +    "next_call": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "args": {
      +          "type": "object"
      +        },
      +        "tool": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "tool",
      +        "args"
      +      ],
      +      "type": "object"
      +    },
      +    "next_step": {
      +      "type": "string"
      +    },
      +    "next_url": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "code",
      +    "next_step"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / graph
      Added value: +{
      +  "properties": {
      +    "aer": {
      +      "const": "draft-zambo-aer1-20"
      +    },
      +    "schema": {
      +      "const": "zambo.graph/1"
      +    }
      +  },
      +  "required": [
      +    "schema",
      +    "aer",
      +    "nodes",
      +    "edges",
      +    "retries",
      +    "sources",
      +    "summary"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / human_line / maxLength
      Added value: +200
    • addedOutput schema / properties / human_line / pattern
      Added value: +"^[^\\r\\n]*$"
    • addedOutput schema / properties / ids
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / next
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedOutput schema / properties / ok
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / renew_nudge
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / urls
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "result"
      -]New value: +[
      +  "result",
      +  "ok",
      +  "human_line",
      +  "next",
      +  "ids",
      +  "urls"
      +]
  13. Changed1 schema field changed
    • changedInput schema / properties / x_payment / description
      Previous value: -"Base64 JSON x402 payment envelope signed from the live challenge, sent as X-Payment."New value: +"Base64 JSON x402 payment envelope wallet-authorized from the live challenge, sent as X-Payment."
  14. Changed14 schema fields changed
    • addedOutput schema / properties / active
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / daily_recap
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / day_pass
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / expires_at
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / human_line
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / intents
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / next_up
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / payment
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / resume_status
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / resumed_result
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / seconds_left
      Added value: +{
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / tier
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / today_url
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / unlock_link
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  15. Changed3 schema fields changed
    • changedInput schema / examples
      Previous value: -[
      -  {
      -    "payment_method": "x402"
      -  }
      -]New value: +[
      +  {
      +    "_session_id": "73513c44-6969-435e-86eb-0fc262521fd1"
      +  }
      +]
    • addedInput schema / properties / sponsor
      Added value: +{
      +  "description": "Explicitly sponsor another team's closed workflow; branding ownership never transfers.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / workflow_id
      Added value: +{
      +  "description": "Optional workflow to seal after verified payment.",
      +  "format": "uuid",
      +  "type": "string"
      +}
  16. Changed4 schema fields changed
    • changedInput schema / properties / _caller_label / description
      Previous value: -"Optional self-reported caller label. It is recorded as a claim, not independently verified."New value: +"Optional caller label recorded as a caller-reported claim in the receipt."
    • changedInput schema / properties / _session_id / description
      Previous value: -"Optional stable Zambo session ID used to preserve continuity across tool calls."New value: +"Optional stable bot-job ID. Reuse it across calls to bind a Day Pass and keep the job ledger together."
    • addedInput schema / properties / _zambo_key
      Added value: +{
      +  "description": "Optional opaque Zambo access capability. Never place it in a URL or public log.",
      +  "maxLength": 160,
      +  "type": "string"
      +}
    • removedInput schema / properties / human_approved
      Removed value: -{
      -  "description": "Must be true only after the human explicitly approved this $0.99 USDC payment. Required when sending x_payment.",
      -  "type": "boolean"
      -}
  17. Changed9 schema fields changed
    • changedOutput schema / additionalProperties
      Previous value: -trueNew value: +false
    • removedOutput schema / properties / access_key
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / activated
      Removed value: -{
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / already_active
      Removed value: -{
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / expires_at
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / how_to_use
      Removed value: -{
      -  "additionalProperties": true,
      -  "type": "object"
      -}
    • addedOutput schema / properties / result
      Added value: +{
      +  "description": "The tool's observed JSON value or plain-text result."
      +}
    • removedOutput schema / properties / x711_credits
      Removed value: -{
      -  "type": "number"
      -}
    • addedOutput schema / required
      Added value: +[
      +  "result"
      +]
  18. Changed1 schema field changed
    • addedInput schema / properties / session_id
      Added value: +{
      +  "description": "Alias for _session_id.",
      +  "maxLength": 64,
      +  "type": "string"
      +}
  19. Changed2 schema fields changed
    • addedInput schema / properties / _caller_label
      Added value: +{
      +  "description": "Optional self-reported caller label. It is recorded as a claim, not independently verified.",
      +  "maxLength": 80,
      +  "type": "string"
      +}
    • addedInput schema / properties / _session_id
      Added value: +{
      +  "description": "Optional stable Zambo session ID used to preserve continuity across tool calls.",
      +  "maxLength": 64,
      +  "type": "string"
      +}
  20. Changed1 schema field changed
    • addedInput schema / properties / human_approved
      Added value: +{
      +  "description": "Must be true only after the human explicitly approved this $0.99 USDC payment. Required when sending x_payment.",
      +  "type": "boolean"
      +}
  21. Changed1 schema field changed
    • addedInput schema / properties / _continuity_ai_label
      Added value: +{
      +  "description": "Optional self-reported AI client label for the private continuity timeline. Zambo does not independently verify the client.",
      +  "maxLength": 48,
      +  "type": "string"
      +}
  22. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already flag destructive=true and non-idempotent, so the bar is lower, and the description still adds real behavior: activation only follows a verified transfer, the challenge/verified-result branching, and the contents of the result (receipt URL, run ID, access key, expiration, spend receipt). It does not disclose the cost, what a repeat call does to an already-active pass, or failure modes, which keeps it below 5.

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?

Five short sentences, front-loaded with the action and outcome, with no filler sentences. Minor waste in restating the result payload ('returns ... verified activation result' followed by 'Activation results include ...') and in the vague 'Agent-native' opener.

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

Completeness5/5

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

Not applicable — scored here instead as 3.

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 100% across all 10 parameters, so the schema carries the semantic load and a 3 is the baseline. The description only loosely maps to parameters by referring to a 'payment envelope' (x_payment) and 'existing access key' (_zambo_key), adding no format, precedence, or interaction guidance beyond the schema.

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 names a concrete verb (activate) and resource (Day Pass / access) and describes the two-outcome contract: it returns either a payment challenge or a verified activation result. It stops short of distinguishing itself from close siblings such as day_pass_redeem, day_pass_checkout_link, and day_pass_status, so an agent cannot fully rule out the alternatives from the text alone.

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 through the flow ('accepts an optional payment envelope or existing access key'), which suggests call-without-payment to get a challenge and call-with-payment to complete. There is no explicit statement of when to prefer this over day_pass_redeem or day_pass_checkout_link, and no exclusions or preconditions are spelled out.

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.