Skip to main content
Glama

search_gift_cards

Read-onlyIdempotent

Search the gift card catalog

Browse and search available gift cards. Returns a list of gift card products with pricing, denomination, and catalog information. Use the laso_server_id from the results to order a card via GET /order-gift-card.

Every response includes a facets object listing the valid values for the category, currency, and country filters. The facets are computed from the full catalog, so a single unfiltered request (no query parameters) is enough to discover everything you can filter on.

This is a free endpoint — no x402 payment required.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "search_gift_cards"
  }
}

Input Schema

NameRequiredDescriptionDefault
qNoSearch query to filter gift cards by name (e.g. "Amazon", "Uber")
countryNoISO 3166-1 alpha-2 country code to filter by (e.g. "US", "GB"). Returns gift cards available in that country, including borderless products that have no country restriction.
categoryNoCategory to filter by (e.g. "ecommerce", "travel", "gaming"). See the `facets.categories` array in any response for the full list of valid values.
currencyNoCurrency code to filter by (e.g. "USD", "EUR")

Output Schema

NameRequiredDescriptionDefault
countNoNumber of results returned
facetsNoValid filter values, computed from the full catalog. Use these to discover what you can pass to the `category`, `currency`, and `country` query parameters.
filtersNo
gift_cardsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / gift_cards / items / properties / increment / description
      Previous value: -"Minimum order increment"New value: +"Step the order amount must be a multiple of, in the product's currency. Usually \"1\" (whole units only, so 160.7 is rejected before payment). \"0\" means the product is only sold at the values in denominations."
  2. Changed2 schema fields changed
    • removedInput schema / properties / auth_token
      Removed value: -{
      -  "description": "Laso credential. Only if the MCP connection has no Authorization header.",
      -  "type": "string"
      -}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "count": {
      +      "description": "Number of results returned",
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "facets": {
      +      "description": "Valid filter values, computed from the full catalog. Use these to discover what you can pass to the `category`, `currency`, and `country` query parameters.",
      +      "properties": {
      +        "categories": {
      +          "description": "All valid `category` filter values.",
      +          "items": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "type": [
      +            "array",
      +            "null"
      +          ]
      +        },
      +        "countries": {
      +          "description": "All valid `country` filter values (ISO 3166-1 alpha-2 codes).",
      +          "items": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "type": [
      +            "array",
      +            "null"
      +          ]
      +        },
      +        "currencies": {
      +          "description": "All valid `currency` filter values.",
      +          "items": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "type": [
      +            "array",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "filters": {
      +      "properties": {
      +        "category": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "country": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "currency": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "query": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "gift_cards": {
      +      "items": {
      +        "description": "A gift card product from the catalog.",
      +        "properties": {
      +          "catalog_info": {
      +            "properties": {
      +              "brand_description": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "redemption_instructions": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": [
      +              "object",
      +              "null"
      +            ]
      +          },
      +          "category": {
      +            "description": "Catalog category for the gift card (e.g. \"ecommerce\", \"travel\").",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "country": {
      +            "description": "ISO 3166-1 alpha-2 country the gift card belongs to. Null for borderless products available in more than one country.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "currency": {
      +            "description": "Currency code for the gift card",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "denominations": {
      +            "description": "If set, only these exact amounts can be ordered. Null for range-based products.",
      +            "items": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "type": [
      +              "array",
      +              "null"
      +            ]
      +          },
      +          "description": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "increment": {
      +            "description": "Minimum order increment",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "laso_server_id": {
      +            "description": "Product identifier to use when ordering via GET /order-gift-card",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "max": {
      +            "description": "Maximum order amount",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "min": {
      +            "description": "Minimum order amount",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "name": {
      +            "description": "Gift card brand name",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "product_image_url": {
      +            "description": "URL of the gift card image",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -{
      -  "properties": {
      -    "count": {
      -      "description": "Number of results returned",
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "facets": {
      -      "description": "Valid filter values, computed from the full catalog. Use these to discover what you can pass to the `category`, `currency`, and `country` query parameters.",
      -      "properties": {
      -        "categories": {
      -          "description": "All valid `category` filter values.",
      -          "items": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "type": [
      -            "array",
      -            "null"
      -          ]
      -        },
      -        "countries": {
      -          "description": "All valid `country` filter values (ISO 3166-1 alpha-2 codes).",
      -          "items": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "type": [
      -            "array",
      -            "null"
      -          ]
      -        },
      -        "currencies": {
      -          "description": "All valid `currency` filter values.",
      -          "items": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "type": [
      -            "array",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "filters": {
      -      "properties": {
      -        "category": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "country": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "currency": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "query": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "gift_cards": {
      -      "items": {
      -        "description": "A gift card product from the catalog.",
      -        "properties": {
      -          "catalog_info": {
      -            "properties": {
      -              "brand_description": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              },
      -              "redemption_instructions": {
      -                "type": [
      -                  "string",
      -                  "null"
      -                ]
      -              }
      -            },
      -            "type": [
      -              "object",
      -              "null"
      -            ]
      -          },
      -          "category": {
      -            "description": "Catalog category for the gift card (e.g. \"ecommerce\", \"travel\").",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "country": {
      -            "description": "ISO 3166-1 alpha-2 country the gift card belongs to. Null for borderless products available in more than one country.",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "currency": {
      -            "description": "Currency code for the gift card",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "denominations": {
      -            "description": "If set, only these exact amounts can be ordered. Null for range-based products.",
      -            "items": {
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "type": [
      -              "array",
      -              "null"
      -            ]
      -          },
      -          "description": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "increment": {
      -            "description": "Minimum order increment",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "laso_server_id": {
      -            "description": "Product identifier to use when ordering via GET /order-gift-card",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "max": {
      -            "description": "Maximum order amount",
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "min": {
      -            "description": "Minimum order amount",
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "name": {
      -            "description": "Gift card brand name",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "product_image_url": {
      -            "description": "URL of the gift card image",
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "type": [
      -        "array",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": "object"
      -}New value: +null
  4. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, openWorldHint=false and destructiveHint=false, so safety is covered. The description adds genuinely new behavioral context beyond annotations: the facets object is computed from the full catalog (explaining result shape semantics) and the endpoint is free with no x402 payment required, which matters in a catalog that mixes paid and free endpoints.

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?

Three short, front-loaded paragraphs: what it does, how filters are discovered, and the cost profile. Every sentence carries information. Slightly more than strictly necessary given the input schema already names the filters, but nothing is wasted.

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?

Output schema exists, yet the description still usefully sketches the return shape (products with pricing, denomination, catalog info) and the facets object. Combined with the free-endpoint note and the ordering handoff, an agent has everything needed to call this correctly and act on the results.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3 and the schema already documents each filter with examples. The description goes beyond that by explaining the facet mechanism — that valid values for category, currency and country can be discovered from any response — which adds meaning about how to use the parameters correctly rather than just restating them.

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 specific verb and resource ('Search the gift card catalog') and immediately clarifies scope via 'Browse and search available gift cards.' It also distinguishes itself from the ordering sibling by naming the handoff field (`laso_server_id`) and the downstream tool (`GET /order-gift-card`), so an agent can tell search apart from order_gift_card without opening either schema.

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

Usage Guidelines4/5

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

Gives clear operational context: a single unfiltered request is sufficient to discover all filterable values, and results feed into order_gift_card. This is strong routing and usage guidance. It stops short of explicit when-not-to-use conditions or edge cases, so it is not a 5.

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