Skip to main content
Glama

Look a row up by an exact key

dataset_row

The rows of the DamageRestore HQ 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. Dates show when Glama detected each change.

  1. First observed

TDQS

B3.3/5.0
Behavior3/5

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

With no annotations, the description carries the behavioral burden and does add meaningful behavior: exact match with case-insensitivity. It does not disclose output shape, whether multiple rows can be returned, pagination, or error behavior, so coverage is only partial.

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 a single tight sentence with no filler, and the key qualifiers "exactly" and "case-insensitive" are placed early. It is appropriately sized for the tool's simplicity.

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 output schema, the core matching semantic is conveyed well enough to begin using the tool. However, unresolved singular-vs-plural behavior, lack of explicit sibling differentiation, and no return/error details leave the description minimally sufficient rather than complete.

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?

The schema has 0% description coverage, so the description must compensate. It only restates the column-equals-value relationship, which is close to the parameter names, and adds case-insensitivity; it does not clarify column naming, allowed values, or match formatting. The parameter documentation gap remains largely unfilled.

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 clearly identifies exact-match row filtering against a named dataset, and the "exactly (case-insensitive)" phrasing distinguishes it from fuzzy search siblings. However, the title says "a row" while the description says "rows," leaving singular-vs-plural scope slightly ambiguous.

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

Usage Guidelines3/5

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

The exact-equality wording implies this tool is for precise key lookups rather than dataset_search or other comparison tools, but no alternative is explicitly named. Usage context is inferred rather than stated with when-to-use or when-not-to-use guidance.

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

A3.9/5.0
Disambiguation5/5

Each tool targets a distinct operation: schema inspection, row filtering, comparison, provenance, exact match, search, statistics, and top/bottom rows. No two tools overlap in purpose.

Naming Consistency5/5

All tools follow a consistent 'dataset_' prefix with clear noun/verb suffixes (columns, compare, provenance, row, search, stats, top). Pattern is uniform and predictable.

Tool Count5/5

Seven tools cover the core dataset exploration operations without bloat. Each earns its place for a data querying server.

Completeness5/5

The set covers schema, row retrieval, search, comparison, statistical summaries, provenance, and top/bottom queries—complete for read-only data exploration. No gaps for typical dataset questions.

Resources