Skip to main content
Glama

x402-first-n-lines

First N Lines: First N Lines

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nNoN to process
textNoText to process
inputNoInput to process

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / input
      Added value: +{
      +  "description": "Input to process",
      +  "type": "string"
      +}
    • addedInput schema / properties / n
      Added value: +{
      +  "description": "N to process",
      +  "type": "string"
      +}
    • addedInput schema / properties / text
      Added value: +{
      +  "description": "Text to process",
      +  "type": "string"
      +}
  2. First observed

TDQS

D1.5/5.0
Behavior1/5

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

No annotations exist, so the description carries the full behavioral burden and delivers none of it: no statement about how N is interpreted (number? string? default when omitted?), what happens on out-of-range N, how lines are delimited, or what the return shape is. The description adds nothing beyond the title text.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The entry is tiny and waste-free in the literal sense, but this is under-specification rather than conciseness: the single sentence duplicates the title verbatim and front-loads nothing useful. Being short does not earn credit when the content is absent.

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

Completeness1/5

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

For a 3-parameter tool with no annotations, no output schema, and uninformative parameter descriptions, the definition is far too thin to let an agent invoke it correctly. Nothing covers defaults, delimiters, the text-vs-input ambiguity, or the result format.

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 nominally 100%, which normally sets a baseline of 3, but the schema descriptions are placeholders ('N to process', 'Text to process', 'Input to process') that do not disambiguate anything. Three optional parameters exist where 'text' and 'input' appear near-synonymous and no description explains which to use, what the default N is, or whether N is numeric despite being typed as string.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'First N Lines: First N Lines' is essentially a tautology that restates the name/title twice without adding a verb-resource framing or stating what the output is. It does gesture at a recognizable text operation (extracting the first N lines), which keeps it from being a pure 1, but it gives no differentiation from the sibling x402-last-n-lines or other line tools.

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

Usage Guidelines1/5

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

There is no guidance on when to use this tool, when not to, or which sibling to prefer. With siblings like x402-last-n-lines, x402-line-count, x402-head-like tools, and x402-grep-lines, disambiguation was genuinely needed and none is provided.

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