Skip to main content
Glama

Laso Finance

by finance.laso
OverviewDiscussionsAdmin

search_gift_cards

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.

Input Schema

TableJSON 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")
auth_tokenNoLaso credential. Only if the MCP connection has no Authorization header.

Schema Changelog

Changes observed during successful MCP inspections.

  1. 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
  2. First observed

TDQS

A4.3/5.0
Behavior4/5

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

Since no annotations are provided, the description carries the full burden. It discloses that it's a free endpoint (no x402 payment), returns facets computed from the full catalog, and provides the ordering path. It does not mention pagination or rate limits, but for a search tool this is acceptable and adds value beyond a simple 'search' statement.

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?

The description is concise and front-loaded with the purpose. Each sentence adds value: purpose, return contents, ordering path, facets discovery, and free status. No fluff or redundancy.

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?

The description provides enough context for an agent to use the tool correctly: what it returns, how to order using the results, how to discover filters, and that it's free. With no output schema, it still describes the output and the workflow, making it complete for this search tool.

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% with each parameter having a description. The description adds some context about how facets relate to parameters, but does not substantially expand on parameter semantics beyond what the schema already provides. Baseline of 3 applies.

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?

The description clearly states the tool searches and browses the gift card catalog, returning a list of products with pricing and catalog info. It distinguishes from siblings like search_merchants and order_gift_card by focusing specifically on gift cards, making its purpose unambiguous.

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?

The description provides clear usage context: it explains the workflow of using the returned `laso_server_id` to order via `GET /order-gift-card`, and notes that a single unfiltered request can discover all valid filter values via facets. However, it does not explicitly state when not to use this tool or mention alternatives, so it lacks exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Laso Finance toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources