Skip to main content
Glama

SEON (Unofficial)

Company Register Search

company_register_search
Read-onlyIdempotent

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 Companies Registration Office (IE), the US STATE business registers (one per state the sos-entities pack covers; pass country "US", optionally with a two-letter state), and the GLEIF LEI crosswalk, which reaches jurisdictions we have no register pack for (DE, SE, AU, SG...). US EXAMPLE: {name: "IPQualityScore LLC", country: "US", state: "FL"} returns the Florida entity number. A US company is formed in ONE state and may also be registered as a FOREIGN entity in others, so without state every covered state register is searched and the several registrations of one company come back as ONE match, which says whether the register it names is the company's own or a foreign registration and names the state it was formed in (Browserbase Inc. is a Delaware corporation found in New York). A state we hold no register for (Delaware, California and most others) is SAID so, and is answered from GLEIF (the state file number GLEIF holds for the company, returned as gleif_state_registration and labelled as GLEIF's copy, not a lookup in the state's register) and SEC EDGAR (the registrant's state of incorporation, sec_state_of_incorporation), with the counts and what a miss means in state_coverage.indirect_sources and the explanation; the covered registers are also searched for foreign registrations of a company formed there. A company with neither an LEI nor an SEC filing is not found, so a miss is never proof it is not a company of that state. With state, match_status: "matched" means the row is that state's own register or says the company was formed there; a same-name registration in another register that does not say where the company was formed comes back as a candidate with match_scope: "formation_unstated" ("other_formation" when it states another place of formation), never as the match, and registered_elsewhere counts those registrations as evidence the company exists, none about the state. Without country, a name that two jurisdictions both hold exactly is ambiguous with both rows listed, never decided by a status or LEI penalty (pass country to choose); with country US and no state, SEC EDGAR is asked too, and a state register that could not answer is named under unavailable_registers without voiding an exact-form match. For US public companies prefer resolve_entity (CIK + ticker + FIGI). THIS TOOL REFUSES TO GUESS, and that is its point: when two different companies match a name equally well it answers match_status: "ambiguous" with BOTH, rather than naming one. A one-word trading name usually IS ambiguous, "Bolt", "Apple", "Next", "Sea", "DNB" each match a well-known group AND unrelated micro-entities whose registered name is exactly that word, so pass country when you know it. Every response names EVERY register it asked under searched[], with that register's own as-of date and row count, and a register that could not be reached carries an error there rather than reading as zero rows: "we could not ask Companies House" is never the same answer as "this company is not in Britain". related[] holds entities that collapsed INTO the match, the same company seen through another register, or another country's arm sharing its LEI, so a multinational returns one answer rather than tying with itself. NOT A PEOPLE SEARCH: sole traders and other natural persons are excluded on the publisher's own legal-form field, never guessed from the shape of a name. resolve_entity shares this matcher and returns these register fields too, but searches the US state registers only through this tool.

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": "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. Changed1 schema field changed
    • changedInput schema / properties / state / description
      Previous value: -"OPTIONAL two-letter US state (\"FL\", \"NY\", \"CO\"...), with country \"US\" (implied when country is absent). 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."New value: +"OPTIONAL 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."
  2. Changed1 schema field changed
    • changedInput schema / properties / state / description
      Previous value: -"OPTIONAL two-letter US state (\"FL\", \"NY\", \"CO\"...), with country \"US\" (implied when country is absent). A state we hold a register for narrows the search to that register alone. A state we do not (Delaware, California) is reported in `state_coverage` with the covered states named, and every covered register is searched for foreign registrations of a company formed there. Omit to search every covered state register."New value: +"OPTIONAL two-letter US state (\"FL\", \"NY\", \"CO\"...), with country \"US\" (implied when country is absent). 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."
  3. Changed1 schema field changed
    • changedInput schema / properties / name / description
      Previous value: -"The 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."New value: +"The 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."
  4. Changed3 schema fields changed
    • changedInput schema / examples
      Previous value: -[
      -  {
      -    "country": "NO",
      -    "name": "Equinor ASA"
      -  },
      -  {
      -    "country": "JP",
      -    "name": "株式会社花王"
      -  },
      -  {
      -    "country": "EE",
      -    "name": "Bolt"
      -  }
      -]New value: +[
      +  {
      +    "country": "NO",
      +    "name": "Equinor ASA"
      +  },
      +  {
      +    "country": "JP",
      +    "name": "株式会社花王"
      +  },
      +  {
      +    "country": "EE",
      +    "name": "Bolt"
      +  },
      +  {
      +    "country": "US",
      +    "name": "IPQualityScore LLC",
      +    "state": "FL"
      +  },
      +  {
      +    "country": "IE",
      +    "name": "Roadstone Limited"
      +  }
      +]
    • changedInput schema / properties / country / description
      Previous value: -"OPTIONAL ISO 3166-1 alpha-2 of the register you mean (\"GB\", \"NO\", \"FI\", \"FR\", \"JP\", \"EE\", \"BR\"). Narrows the fan-out, and is frequently the difference between an answer and `ambiguous` on a short name. The GLEIF crosswalk is asked whatever you pass, because for several jurisdictions it is the only register we can name at all."New value: +"OPTIONAL 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."
    • addedInput schema / properties / state
      Added value: +{
      +  "description": "OPTIONAL two-letter US state (\"FL\", \"NY\", \"CO\"...), with country \"US\" (implied when country is absent). A state we hold a register for narrows the search to that register alone. A state we do not (Delaware, California) is reported in `state_coverage` with the covered states named, and every covered register is searched for foreign registrations of a company formed there. Omit to search every covered state register.",
      +  "type": "string"
      +}
  5. Added

TDQS

A4.7/5.0
Behavior5/5

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

Annotations only establish read-only/idempotent/open-world; the description goes far beyond by disclosing the refuse-to-guess ambiguity policy, `match_status`/`match_scope` outcomes, `related[]` collapsing, `searched[]` as-of dates, and the critical distinction that an unreachable register carries an `error` rather than reading as zero rows. These are behavioral traits no annotation could convey.

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

Conciseness3/5

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

Purpose and scope are front-loaded, but the body is a dense wall of text with repeated emphasis (refuse-to-guess, ambiguity, GLEIF caveats) and long enumerations of registers and identifiers that could be compressed. Almost every sentence carries information, yet the presentation makes it hard to scan.

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

Completeness5/5

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

There is no output schema, so the description has to carry return-value meaning — and it does, defining `match_status`, `match_scope`, `searched[]`, `related[]`, `unavailable_registers`, `state_coverage.indirect_sources`, `gleif_state_registration` and `sec_state_of_incorporation`. An agent has enough to interpret both hits and misses.

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?

Schema coverage is 100% and the parameter descriptions already carry most of the semantics (verbatim name, formation-vs-HQ state, country narrowing). The tool description still adds cross-parameter behavior the schema cannot show alone — e.g. that IE and US registers are only asked when those countries are passed, and that omitting `state` merges multiple state registrations into one match.

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?

Opens with a concrete verb+resource ('Search the NATIONAL BUSINESS REGISTERS by company name') and names the exact return identity (register id, company number, LEI, etc.). It immediately distinguishes itself from resolve_entity ('searches the US state registers only through this tool') and from people search ('NOT A PEOPLE SEARCH').

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

Usage Guidelines5/5

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

States when to use it (want the OFFICIAL REGISTERED ENTITY), when to prefer the sibling ('For US public companies prefer resolve_entity (CIK + ticker + FIGI)'), and how to disambiguate by passing `country` and `state`. It even explains what a miss means and why it is not proof of non-existence.

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.