Skip to main content
Glama

Day Pass status

day_pass_status
Read-onlyIdempotent

Check your current pass, also available as pass_status. All arguments are optional: current session, token_or_link, thread_id, or _zambo_key. Returns a plain status line, active, tier, expires_at, seconds_left and a private unlock link without spending quota. Product/provider limits may still apply. AER-1 receipt, verifiable offline.

Input Schema

NameRequiredDescriptionDefault
_refNoOptional handover referral ID from your install link.
thread_idNoOptional continuity thread within the current session.
_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.
status_tokenNoOpaque token returned with the human checkout link; it is not the Day Pass key.
_caller_labelNoOptional caller label recorded as a caller-reported claim in the receipt.zambo-starter
token_or_linkNoOptional private /u/ unlock link.
_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. 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"
  3. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-25"New value: +"draft-zambo-aer1-26"
  4. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-24"New value: +"draft-zambo-aer1-25"
  5. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-23"New value: +"draft-zambo-aer1-24"
  6. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-22"New value: +"draft-zambo-aer1-23"
  7. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-21"New value: +"draft-zambo-aer1-22"
  8. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-20"New value: +"draft-zambo-aer1-21"
  9. Changed1 schema field changed
    • addedOutput schema / properties / next_steps
      Added value: +{
      +  "items": {},
      +  "minItems": 1,
      +  "type": "array"
      +}
  10. Changed29 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 / 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 / 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 / expires_at
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • 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
      Added value: +{
      +  "maxLength": 200,
      +  "pattern": "^[^\\r\\n]*$",
      +  "type": "string"
      +}
    • addedOutput schema / properties / ids
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / intents
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / next
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedOutput schema / properties / next_up
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / ok
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / payment
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / renew_nudge
      Added value: +{
      +  "type": "object"
      +}
    • removedOutput schema / properties / result / additionalProperties
      Removed value: -true
    • addedOutput schema / properties / result / description
      Added value: +"The tool's observed JSON value or plain-text result."
    • removedOutput schema / properties / result / properties
      Removed value: -{
      -  "active": {
      -    "type": "boolean"
      -  },
      -  "calls_left": {
      -    "oneOf": [
      -      {
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      {
      -        "type": "string"
      -      }
      -    ]
      -  },
      -  "calls_left_scope": {
      -    "type": "string"
      -  },
      -  "expires_at": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "seals": {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "sealed_at": {
      -          "type": "string"
      -        },
      -        "workflow_id": {
      -          "type": "string"
      -        },
      -        "workflow_url": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "workflow_id",
      -        "workflow_url",
      -        "sealed_at"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "session_bound": {
      -    "type": "boolean"
      -  },
      -  "status": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / result / required
      Removed value: -[
      -  "status",
      -  "active",
      -  "expires_at",
      -  "calls_left",
      -  "seals"
      -]
    • removedOutput schema / properties / result / type
      Removed value: -"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"
      +  ]
      +}
    • 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"
      +]
  11. Changed2 schema fields changed
    • addedInput schema / properties / thread_id
      Added value: +{
      +  "description": "Optional continuity thread within the current session.",
      +  "type": "string"
      +}
    • addedInput schema / properties / token_or_link
      Added value: +{
      +  "description": "Optional private /u/ unlock link.",
      +  "type": "string"
      +}
  12. Changed5 schema fields changed
    • addedOutput schema / properties / result / additionalProperties
      Added value: +true
    • removedOutput schema / properties / result / description
      Removed value: -"The tool's observed JSON value or plain-text result."
    • addedOutput schema / properties / result / properties
      Added value: +{
      +  "active": {
      +    "type": "boolean"
      +  },
      +  "calls_left": {
      +    "oneOf": [
      +      {
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      {
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  "calls_left_scope": {
      +    "type": "string"
      +  },
      +  "expires_at": {
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  },
      +  "seals": {
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "sealed_at": {
      +          "type": "string"
      +        },
      +        "workflow_id": {
      +          "type": "string"
      +        },
      +        "workflow_url": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "workflow_id",
      +        "workflow_url",
      +        "sealed_at"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  "session_bound": {
      +    "type": "boolean"
      +  },
      +  "status": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / properties / result / required
      Added value: +[
      +  "status",
      +  "active",
      +  "expires_at",
      +  "calls_left",
      +  "seals"
      +]
    • addedOutput schema / properties / result / type
      Added value: +"object"
  13. 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."
    • changedInput schema / properties / _zambo_key / description
      Previous value: -"Optional Day Pass capability key. Never include it in a URL or public log."New value: +"Optional opaque Zambo access capability. Never place it in a URL or public log."
    • addedInput schema / properties / _zambo_key / maxLength
      Added value: +160
  14. Changed9 schema fields changed
    • changedOutput schema / additionalProperties
      Previous value: -trueNew value: +false
    • removedOutput schema / properties / active
      Removed value: -{
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / calls_left
      Removed value: -{
      -  "oneOf": [
      -    {
      -      "type": "string"
      -    },
      -    {
      -      "type": "number"
      -    }
      -  ]
      -}
    • removedOutput schema / properties / calls_left_scope
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / expires_at
      Removed value: -{
      -  "oneOf": [
      -    {
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • addedOutput schema / properties / result
      Added value: +{
      +  "description": "The tool's observed JSON value or plain-text result."
      +}
    • removedOutput schema / properties / session_bound
      Removed value: -{
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / status
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / required
      Added value: +[
      +  "result"
      +]
  15. Added

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive, and open-world, so the safety profile is covered. The description still adds real context beyond that: no quota is consumed, product/provider limits may nonetheless apply, and an offline-verifiable AER-1 receipt is produced – all relevant traits an agent cannot infer from annotations alone.

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?

The most important information – what it does and that it costs no quota – is front-loaded, and the sentences are compact. The trailing 'AER-1 receipt, verifiable offline' is jargon-heavy and slightly marketing-flavoured, but it is one short clause rather than bloat.

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 read-only, zero-required-parameter status tool with a full output schema, this covers what an agent needs: it names the return fields, confirms no quota spend, and warns that provider limits may still bind. The only gap is that it does not say what a non-active status looks like or what an agent should do next on an expired pass.

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 ten parameters, so the schema already carries the semantics and baseline is 3. The description adds only a loose partial enumeration ('current session, token_or_link, thread_id, or _zambo_key') that omits six documented parameters and refers to 'current session' rather than the actual field names, adding little 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 opens with a specific verb+resource ('Check your current pass') and names the alias sibling pass_status, so an agent can tell it apart from day_pass_activate, day_pass_redeem, or day_pass_checkout_link. It stops short of explicitly contrasting with those neighbouring purchase/activation tools.

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?

It implies usage through 'without spending quota' and the alias mention, which hints that this is the free, safe way to inspect state rather than to buy or redeem. There is no explicit when-not guidance or named alternative for cases where the agent should call day_pass_checkout_link or day_pass_activate instead.

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.