International Classifications MCP

Validate classification codes

validate_codes

Read-onlyIdempotent

Validate exact codes against one named classification version.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "classification_id": "<classification_id>",
      "codes": "<codes>"
    },
    "name": "validate_codes"
  }
}

Input Schema

Name	Required	Description	Default
`codes`	Yes
`classification_id`	Yes

Output Schema

Name	Required	Description	Default
`results`	Yes
`valid_count`	Yes
`invalid_count`	Yes
`classification_id`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

First observedOct 1, 2026

TDQS

B3.3/5.0

Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false, and closed-world behavior, so the safety profile is covered. The description adds that validation is scoped to a single named classification version and operates on a batch of codes, but it discloses nothing about the return semantics or what happens to invalid codes.

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?

A single sentence with zero filler, front-loaded with the verb and resource. Every phrase (exact, one named, version) adds scoping information.

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?

Because an output schema exists, the description need not explain return values, and it correctly covers the batch-validate-single-version model. However, with 0% parameter description coverage and no usage guidance among nine siblings, it is only minimally complete for an agent choosing between this and search_codes or recommend_classifications.

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 0%, so the description carries the burden for both parameters. It clarifies that 'codes' are exact strings and 'classification_id' refers to one named version, but it gives no format details, no source for the identifier, and no indication of how validation results map back to individual codes.

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 verb (validate) and resource (codes) with a scoping qualifier ('exact', 'one named classification version'). The word 'exact' implicitly distinguishes it from fuzzy-search siblings like search_codes and recommend_classifications, though no sibling is named explicitly.

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 guidance. The phrase 'exact codes' weakly implies this is for codes you already hold rather than discovery, but no alternative tool is named and no prerequisites or context are given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All International Classifications MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.