Skip to main content
Glama

Claim a free slot for a product

claim_free_slot

Put a product on the board in a slot nobody holds. Costs nothing: an empty slot has no standing bid to beat, so any amount takes it, zero included. No account and no card. The name, logo and description are read from the site automatically. One free claim per registrable domain per day, and only for today or tomorrow — booking further ahead is for bidders on the site. If somebody outbids it later the slot is lost, but nothing was paid, so nothing is lost with it.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
urlYesThe product's website, e.g. https://acme.com
nameNoOverrides the name read from the site.
dayKeyNoUTC day, "YYYY-MM-DD". Today by default; at most 1 day(s) ahead.
taglineNoOne line shown under the name.
categoryNoWhat the product is.
slotIndexYesWhich slot, 0 to 1. Call get_board first to find a free one.

TDQS

A4.3/5.0
Behavior5/5

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

The description goes well beyond the annotations by explaining costs, lack of account/card requirement, automatic site reading, per-day/domain limits, future-date restrictions, and the risk of being outbid later. These are exactly the behavioral traits an agent needs to know, and nothing in the description contradicts the annotations.

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 description is well-structured and front-loaded with the core action, then expands to cost, constraints, and consequences. It is slightly wordy in places, such as 'so any amount takes it, zero included' and the closing 'nothing was lost with it,' but every sentence contributes useful context.

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 write operation with no output schema, the description covers cost, authentication, time constraints, rate limits, and failure consequences — enough for an agent to decide whether and how to invoke it. The main gap is the lack of any indication of what the tool returns on success, though the absence of an output schema makes this less critical.

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%, so the parameter schema already documents url, name, dayKey, tagline, category, and slotIndex thoroughly. The tool description adds no parameter-specific detail beyond the schema; it enriches the overall context but does not add meaning to individual parameters.

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 uses a specific verb-plus-resource construction: 'Put a product on the board in a slot nobody holds.' It clearly identifies the action, the target resource, and the key condition (free/unclaimed slot), and it is obviously distinct from the read-only sibling tools like get_board and get_slot_price.

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 clearly states when this tool is appropriate: for free claims, with no account or card, limited to today or tomorrow, and one claim per registrable domain per day. It also hints at the alternative path for further-ahead bookings ('booking further ahead is for bidders on the site'), though it does not explicitly name a sibling tool as the alternative.

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.

TDQS

A4.1/5.0
Disambiguation4/5

Each tool targets a distinct resource or action, but get_slot_price and get_board overlap in that the board already shows how much slots are held for and which are free. The remaining tools are clearly separated by board, brand, site, and winners.

Naming Consistency5/5

All tool names use a consistent verb_noun snake_case pattern: get_board, get_stats, get_slot_price, get_brand_stats, list_winners, and claim_free_slot. The mix of get and list is predictable and readable.

Tool Count5/5

Six tools is well-scoped for this domain, covering board state, pricing, statistics, winners, and the one free-slot mutation. Each tool earns its place without bloat or thinness.

Completeness3/5

The read and analytics side is well covered, and free-slot claiming is possible, but the core bidding/outbid lifecycle is absent: get_slot_price tells an agent what it would take to take an occupied slot, yet there is no place_bid, update_bid, or release tool. This leaves a notable dead end for participating in the main BidSurvivor mechanic.

Resources