Skip to main content
Glama

Claim a free 25-call trial

claim_free_trial

One-time pass: 25 successful calls shared across supported single-domain tools, valid 30 days and independent of IP. Excludes private lookup, quote redemption and paid email inboxes. Takes one active Base wallet or a work email (no email is sent). The pass goes in the X-Trial-Token header or MCP metadata hirepulse/trial_token.

Input Schema

NameRequiredDescriptionDefault
emailNoA work email address; free mailbox providers are not accepted.
walletNoA Base address with at least one transaction or $0.10 USDC.

Output Schema

NameRequiredDescriptionDefault
callsNo
statusNo
expires_atNo
how_to_useNo
trial_tokenNoSecret bearer capability. Keep private; never publish or log.
demo_domains_always_freeNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed16 schema fields changed
    • addedInput schema / description
      Added value: +"Provide exactly one of wallet or email, never both. The server validates eligibility before issuing a trial."
    • removedInput schema / oneOf
      Removed value: -[
      -  {
      -    "not": {
      -      "required": [
      -        "email"
      -      ]
      -    },
      -    "required": [
      -      "wallet"
      -    ]
      -  },
      -  {
      -    "not": {
      -      "required": [
      -        "wallet"
      -      ]
      -    },
      -    "required": [
      -      "email"
      -    ]
      -  }
      -]
    • addedOutput schema / description
      Added value: +"Fields only; full schema in GET /v1/catalog."
    • removedOutput schema / properties / calls / const
      Removed value: -25
    • removedOutput schema / properties / calls / type
      Removed value: -"integer"
    • removedOutput schema / properties / demo_domains_always_free / items
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / demo_domains_always_free / type
      Removed value: -"array"
    • removedOutput schema / properties / expires_at / format
      Removed value: -"date-time"
    • removedOutput schema / properties / expires_at / type
      Removed value: -"string"
    • removedOutput schema / properties / how_to_use / properties
      Removed value: -{
      -  "http_header": {
      -    "type": "string"
      -  },
      -  "mcp": {
      -    "type": "string"
      -  },
      -  "note": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / how_to_use / type
      Removed value: -"object"
    • removedOutput schema / properties / status / const
      Removed value: -"ok"
    • removedOutput schema / properties / status / type
      Removed value: -"string"
    • removedOutput schema / properties / trial_token / pattern
      Removed value: -"^hpt_[a-f0-9]{48}$"
    • removedOutput schema / properties / trial_token / type
      Removed value: -"string"
    • removedOutput schema / required
      Removed value: -[
      -  "status",
      -  "trial_token",
      -  "calls",
      -  "expires_at",
      -  "how_to_use",
      -  "demo_domains_always_free"
      -]
  2. Changed16 schema fields changed
    • removedInput schema / description
      Removed value: -"Provide exactly one of wallet or email, never both. The server validates eligibility before issuing a trial."
    • addedInput schema / oneOf
      Added value: +[
      +  {
      +    "not": {
      +      "required": [
      +        "email"
      +      ]
      +    },
      +    "required": [
      +      "wallet"
      +    ]
      +  },
      +  {
      +    "not": {
      +      "required": [
      +        "wallet"
      +      ]
      +    },
      +    "required": [
      +      "email"
      +    ]
      +  }
      +]
    • removedOutput schema / description
      Removed value: -"Fields only; full schema in GET /v1/catalog."
    • addedOutput schema / properties / calls / const
      Added value: +25
    • addedOutput schema / properties / calls / type
      Added value: +"integer"
    • addedOutput schema / properties / demo_domains_always_free / items
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / demo_domains_always_free / type
      Added value: +"array"
    • addedOutput schema / properties / expires_at / format
      Added value: +"date-time"
    • addedOutput schema / properties / expires_at / type
      Added value: +"string"
    • addedOutput schema / properties / how_to_use / properties
      Added value: +{
      +  "http_header": {
      +    "type": "string"
      +  },
      +  "mcp": {
      +    "type": "string"
      +  },
      +  "note": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / properties / how_to_use / type
      Added value: +"object"
    • addedOutput schema / properties / status / const
      Added value: +"ok"
    • addedOutput schema / properties / status / type
      Added value: +"string"
    • addedOutput schema / properties / trial_token / pattern
      Added value: +"^hpt_[a-f0-9]{48}$"
    • addedOutput schema / properties / trial_token / type
      Added value: +"string"
    • addedOutput schema / required
      Added value: +[
      +  "status",
      +  "trial_token",
      +  "calls",
      +  "expires_at",
      +  "how_to_use",
      +  "demo_domains_always_free"
      +]
  3. Changed14 schema fields changed
    • addedOutput schema / description
      Added value: +"Fields only; full schema in GET /v1/catalog."
    • removedOutput schema / properties / calls / const
      Removed value: -25
    • removedOutput schema / properties / calls / type
      Removed value: -"integer"
    • removedOutput schema / properties / demo_domains_always_free / items
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / demo_domains_always_free / type
      Removed value: -"array"
    • removedOutput schema / properties / expires_at / format
      Removed value: -"date-time"
    • removedOutput schema / properties / expires_at / type
      Removed value: -"string"
    • removedOutput schema / properties / how_to_use / properties
      Removed value: -{
      -  "http_header": {
      -    "type": "string"
      -  },
      -  "mcp": {
      -    "type": "string"
      -  },
      -  "note": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / how_to_use / type
      Removed value: -"object"
    • removedOutput schema / properties / status / const
      Removed value: -"ok"
    • removedOutput schema / properties / status / type
      Removed value: -"string"
    • removedOutput schema / properties / trial_token / pattern
      Removed value: -"^hpt_[a-f0-9]{48}$"
    • removedOutput schema / properties / trial_token / type
      Removed value: -"string"
    • removedOutput schema / required
      Removed value: -[
      -  "status",
      -  "trial_token",
      -  "calls",
      -  "expires_at",
      -  "how_to_use",
      -  "demo_domains_always_free"
      -]
  4. Changed2 schema fields changed
    • addedInput schema / description
      Added value: +"Provide exactly one of wallet or email, never both. The server validates eligibility before issuing a trial."
    • removedInput schema / oneOf
      Removed value: -[
      -  {
      -    "not": {
      -      "required": [
      -        "email"
      -      ]
      -    },
      -    "required": [
      -      "wallet"
      -    ]
      -  },
      -  {
      -    "not": {
      -      "required": [
      -        "wallet"
      -      ]
      -    },
      -    "required": [
      -      "email"
      -    ]
      -  }
      -]
  5. Changed2 schema fields changed
    • addedInput schema / oneOf
      Added value: +[
      +  {
      +    "not": {
      +      "required": [
      +        "email"
      +      ]
      +    },
      +    "required": [
      +      "wallet"
      +    ]
      +  },
      +  {
      +    "not": {
      +      "required": [
      +        "wallet"
      +      ]
      +    },
      +    "required": [
      +      "email"
      +    ]
      +  }
      +]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "calls": {
      +      "const": 25,
      +      "type": "integer"
      +    },
      +    "demo_domains_always_free": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "expires_at": {
      +      "format": "date-time",
      +      "type": "string"
      +    },
      +    "how_to_use": {
      +      "properties": {
      +        "http_header": {
      +          "type": "string"
      +        },
      +        "mcp": {
      +          "type": "string"
      +        },
      +        "note": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "status": {
      +      "const": "ok",
      +      "type": "string"
      +    },
      +    "trial_token": {
      +      "description": "Secret bearer capability. Keep private; never publish or log.",
      +      "pattern": "^hpt_[a-f0-9]{48}$",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "status",
      +    "trial_token",
      +    "calls",
      +    "expires_at",
      +    "how_to_use",
      +    "demo_domains_always_free"
      +  ],
      +  "type": "object"
      +}
  6. Added

TDQS

A4.1/5.0
Behavior5/5

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

The description adds substantial behavioral detail beyond annotations: one-time nature, 25 successful calls shared across tools, 30-day validity, IP independence, exclusions, accepted credentials, no email sent, and the token delivery header/metadata. This fully informs an agent about what the tool does and how to use its output.

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?

Four sentences, each earning its place: first states the offer and validity, second lists exclusions, third specifies credit sources, fourth explains token placement. Front-loaded with the core value proposition and zero wasted words.

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?

With an output schema present, the description need not explain return values. It covers eligibility, usage, exclusions, and token handling completely for a 2-parameter tool. An agent has everything needed to invoke it 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 coverage is 100%, so the input schema already documents both email and wallet parameters thoroughly. The description adds minor context ('no email is sent') but does not meaningfully extend parameter semantics beyond the schema. Baseline 3 is appropriate.

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 clearly describes the trial's scope (25 calls, 30 days, shared across supported single-domain tools) and exclusions. It lacks a direct action verb like 'claim' but combined with the title the function is unambiguous. It could more explicitly distinguish this tool from siblings that consume calls.

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 usage (you obtain a one-time pass via wallet or email) and lists exclusions (private lookup, quote redemption, paid email inboxes), but does not explicitly say when to choose this tool over alternatives such as paid tools or other free options. Guidance is inferable but not 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.