Skip to main content
Glama

NS Pros MCP Gateway

newswire-com__company_register_search

Search the NATIONAL BUSINESS REGISTERS by company name and get the register's own id back, a Companies House number, a Norwegian organisasjonsnummer, a Finnish business id, a SIREN, a Japanese corporate number, an Estonian registry code, a CRO number, a CNPJ, a US state entity number, or an LEI. Use this when you want the OFFICIAL REGISTERED ENTITY. Registers searched: Companies House (GB), Enhetsregisteret (NO), PRH/YTJ (FI), Sirene (FR), 法人番号公表サイト (JP), RIK e-Business Register (EE), the Compan

Example tool call

This call uses example arguments supplied in the tool’s input schema.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "name": "Equinor ASA",
      "country": "NO"
    },
    "name": "newswire-com__company_register_search"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameYesThe company name as you have it, in its own script. Pass it VERBATIM, do not strip the legal form ("Oyj", "AS", "株式会社", "Ltd"): in Japanese the form is a PREFIX as often as a suffix and 株式会社花王 and 花王株式会社 are DIFFERENT companies, so the form is often the only evidence that separates two candidates. Diacritics, full-width characters and kana are all handled.
limitNoMaximum candidates to return, 1-50 (default 10). Does not change which registers are asked, only how many rivals come back.
stateNoOPTIONAL two-letter US state ("FL", "NY", "CO"...), with country "US" (implied when country is absent). It means the state where the company is registered or was formed, not where it is headquartered: a Delaware company headquartered in California is "DE", and passing its headquarters state asks a different question (omit `state` if you only know the headquarters). A state we hold a register for narrows the search to that register alone. A state we do not (Delaware, California) is answered from GLEIF and SEC EDGAR, with the coverage stated in `state_coverage`, and every covered register is also searched for foreign registrations of a company formed there. Omit to search every covered state register.
countryNoOPTIONAL ISO 3166-1 alpha-2 of the register you mean ("GB", "NO", "FI", "FR", "JP", "EE", "IE", "US", "BR"). Narrows the fan-out, and is frequently the difference between an answer and `ambiguous` on a short name. The Irish register and the US state registers are asked ONLY when you pass "IE" or "US". The GLEIF crosswalk is asked whatever you pass, because for several jurisdictions it is the only register we can name at all.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior4/5

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

With no annotations supplied, the description carries the behavioral burden and does meaningful work: it discloses the fan-out across registers, that the GLEIF crosswalk is always queried, that uncovered US states are answered from GLEIF and SEC EDGAR with coverage reported in `state_coverage`, and that short names can yield an `ambiguous` result. What is missing is rate-limit/permission context and the text is cut off mid-list, leaving the register enumeration incomplete.

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?

The core purpose and the when-to-use cue are front-loaded in the first two sentences, and the identifier enumeration is dense but each item earns its place by telling the agent what it can receive back. The one real defect is the truncation ("...the Compan"), which leaves a sentence unfinished and wastes the closing position.

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?

For a four-parameter, no-output-schema tool, the description covers what matters: which registers are consulted, what identifier comes back, that ambiguous results are possible, and that coverage metadata (`state_coverage`) accompanies the response. Only the truncated register list and the absence of any result-shape or empty-result guidance keep it from full marks.

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 100% and the property descriptions are unusually rich (verbatim name handling, state-vs-headquarters distinction, country fan-out rules), so the schema does the heavy lifting. The description body adds almost nothing parameter-specific beyond "by company name," so the baseline of 3 applies.

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 description opens with a specific verb and resource ("Search the NATIONAL BUSINESS REGISTERS by company name") and enumerates the exact identifier types returned (Companies House number, organisasjonsnummer, SIREN, CNPJ, LEI, etc.), which precisely defines the output domain. It also names the registers searched, so an agent knows this is the official-registry tool rather than a news or facts lookup.

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 an explicit selection rule: "Use this when you want the OFFICIAL REGISTERED ENTITY." That clearly frames the use case against the sibling company_facts tool. It stops short of naming an alternative or stating when NOT to use it, so it is clear context without exclusions.

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.