Skip to main content
Glama

Look a row up by an exact key

dataset_row

The rows of the Structured Settlement Compare dataset where a column equals a value exactly (case-insensitive).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
valueYes
columnYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.2/5.0
Behavior3/5

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

With no annotations, the description carries the full behavioral burden. It usefully discloses that matching is case-insensitive and that multiple rows ('The rows') may be returned, which are non-obvious traits. However it omits what happens on no match, error behavior, and whether an exact column name is required.

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?

A single tight sentence with no filler, and the exact-match/case-insensitive constraint is front-loaded. It reads as a noun phrase rather than an imperative, but nothing is wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a two-parameter lookup with no annotations and no output schema, the description covers the core purpose and matching semantics but leaves return shape, no-match behavior, and column-name expectations unstated. Adequate but with clear gaps.

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 0%, so both parameters are undocumented in the structured fields. The description loosely maps them by saying 'a column equals a value,' conveying that one input is a column and the other a value with case-insensitive equality, but it gives no format guidance (e.g. valid column names).

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 states a specific outcome: returning rows of the 'Structured Settlement Compare' dataset matching an exact, case-insensitive column/value condition. This is clear enough that an agent knows it's an exact-match lookup, but it never names the sibling it contrasts with (e.g. dataset_search for non-exact queries), so differentiation is left implicit.

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

Usage Guidelines2/5

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

There is no explicit when-to-use or when-not-to-use statement. The word 'exactly' hints that this is the precise-match counterpart to dataset_search, but the agent must infer that routing decision rather than being told it.

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