Skip to main content
Glama

Gbiz Company Records

gbiz_company_records
Read-onlyIdempotent

Patents and trademarks, statutory certifications, government commendations, filed financial results, or workplace statistics for one Japanese company, by its 13-digit corporate number, from gBizINFO (METI). Pick the record type with kind. Workplace statistics carry headcount by sex, average tenure, average age, overtime hours and childcare-leave take-up — the disclosure Japanese employers file under the 女性活躍推進法.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
kindYesWhich record set: "patent", "certification", "commendation", "finance" or "workplace".
limitNoRecords to return, 1-500 (default 50). For "finance" and "workplace", which are one record per company rather than a list, this caps the arrays nested inside it (e.g. the financial period series).
_apiKeyNoOptional. Your own gBizINFO API token, if you would rather use your own quota than the shared one. Register free at https://info.gbiz.go.jp/hojin/various_registration/form — pick 個人利用者 (individual) unless you have a Japanese 法人番号.
corporate_numberYesThe company: its 13-digit Japanese corporate number (法人番号) or its name — a name is resolved, and the Japanese form resolves far more reliably than a romanised one.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.2/5.0
Behavior3/5

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

Annotations already establish read-only, open-world, idempotent, non-destructive behavior, so the description does not need to repeat that. It adds useful context (source is METI/gBizINFO and the workplace fields come from a statutory disclosure), but it does not disclose operational traits such as pagination, return shape, or quota behavior.

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?

Two sentences carry all the essential information: what is returned, from where, for whom, and how to select a record set. No filler, with the core content front-loaded.

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?

Despite having no output schema, the description, combined with the 100%-covered schema and examples, tells an agent enough to make a correct call: supported kinds, corporate-number input, and the special nature of the workplace record. A slight gap is that the exact output arrangement for the other record types is left to inference, but the examples mitigate that.

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

Parameters4/5

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

The schema covers 100% of parameters, so the baseline is 3, and the description adds value by expanding what `kind` can be (patent, certification, commendation, finance, workplace) and by explaining the workplace record's data content. That extra context helps an agent choose a value beyond the schema's terse enum description.

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 opening phrase enumerates exactly what the tool returns (patents/trademarks, certifications, commendations, financial results, workplace statistics) for a single Japanese company keyed by corporate number, from gBizINFO/METI. This content set is distinct from sibling tools like gbiz_company_profile, gbiz_company_search, gbiz_company_procurement, and gbiz_company_subsidies, so an agent can tell them apart.

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?

It gives clear selection context: use it for record sets of one known company, keyed by its 13-digit corporate number, and choose the desired set with `kind`. It does not explicitly name alternatives or say when not to use it, so it misses the top bar for when/when-not 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.