Skip to main content
Glama

claim_listing

INFLUENCE — ask to claim a listing as yours. Returns 202 with a token and the hosts it will be checked against: publish it as a DNS TXT record, or as a file at /.well-known/apis-io-challenge, and leave it up. A PERSON verifies it and emails you — there is nothing else to call. Track it with check_status. Priced B4 (human work) — worked by a person, no charge. See apis://prices.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
slugYes
contextNoOptional: why you are asking. One sentence — the task you are trying to complete, or what you expect to get back. Never included in the answer and never used to rank; it is read only when a result turns out to be wrong, which is when knowing the intent is what makes the report actionable.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.1/5.0
Behavior5/5

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

The description goes well beyond annotations by revealing that this is a human-mediated, asynchronous operation returning 202, requiring DNS or file publication, and ending with manual email verification. It also discloses pricing model and that no further API calls are needed. This is rich behavioral context that the annotations (readOnlyHint=false, destructiveHint=false) do not convey.

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 dense but efficient, front-loading the core purpose and then walking through the asynchronous flow in a compact way. Every sentence adds information; the pricing and no-further-call notes are relevant. The 'INFLUENCE —' prefix is slightly opaque but not wasteful.

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 tool with no output schema and a non-trivial human workflow, the description covers the key elements: status code, token, hosts, verification steps, expected email follow-up, tracking via check_status, and pricing. The main gap is that 'slug' is never defined or tied to how an agent should discover the correct listing identifier.

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

Parameters2/5

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

Schema coverage is only 50%: the required 'slug' parameter is undocumented in the schema, and the description does not explain it beyond the general concept of a listing. The context parameter is well-described in the schema, but the description adds no parameter-level meaning. The token/hosts details refer to the response, not to how arguments should be supplied.

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 states a specific action ('ask to claim a listing as yours') with a clear resource (listing) and outcome (verification token). It is distinguishable from sibling tools like watch_listing or check_status because it centers on claiming ownership, not watching or status-checking.

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 tells the agent when to use it: when you want to claim a listing you own. It also provides clear post-invocation guidance ('there is nothing else to call', 'Track it with check_status'), which effectively scopes the workflow. It does not name alternative claim-related tools or explicitly state when not to use it, so it falls just short of 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