Skip to main content
Glama

Find companies

find_companies
Read-onlyIdempotent

Find private companies in the Corridome database in one call: under one NAICS code or a list of codes searched together, in one state or a list of states, by staff, years in business, PPP loan, and whether the records name an owner or officer with a phone or e-mail. Built from their public records: Form 5500, OSHA, SBA PPP and state registers, employers of 20 or more. Returns how many match (and how they split between the codes), and each company's id, name, place, NAICS code and industry, staff, formation date, PPP loan, the first owner or officer named, and which contacts its records give, the most staff first unless asked otherwise, with its corridome.com address. With include_contacts, it also returns the company's phone and e-mail and a named person's own work line where the records give one, using one credit from the account's monthly allowance for each company opened. Never search one code or one state at a time when the request names several: give them as lists. To choose codes from a description, call find_naics first.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "find_companies"
  }
}

Input Schema

NameRequiredDescriptionDefault
pageNoWhich page of results, from 1.
sortNoThe order: staff (the most staff first), ppp (the largest PPP loan first), oldest or newest (by the day the state register says it was formed), name (A to Z).staff
limitNoHow many results to return, 1 to 50.
naicsNoOne NAICS code, or a list of up to 12 searched together in this one call: ["237130", "238910", "237990"]. Each is 2 to 6 digits, matched as the start of a company's code: 23 is construction, 2382 building equipment contractors, 238220 plumbing and HVAC contractors. To choose codes from a description, call find_naics first.
stateNoOne state, or a list of up to 20 searched together in this one call, as two-letter codes: ["TX", "LA", "OK"].
industryNoWords of the industry's NAICS title, when you don't have the code: plumbing, dental offices, trucking. They are matched to the likeliest code, which the result names, with the other codes that matched.
max_staffNoMost staff.
min_staffNoFewest staff. Staff is the most the records count: a recent OSHA summary or a retirement plan's active participants, else the jobs a PPP loan reported.
max_ppp_usdNoThe largest PPP loan, in US dollars.
min_ppp_usdNoThe smallest PPP loan, in US dollars. Only companies with a PPP loan match.
owner_as_filedNoOnly companies where a state register files someone as an owner, member or partner (never an officer, a director or a plan signer).
include_contactsNoAlso return each company's phone and e-mail, and a named person's own work e-mail or phone, in its row. Each company whose contact is opened uses one credit from the account's monthly allowance, the same credits a person's contact uses; a company with no contact on file costs nothing, and one already opened this month is free. Use it only when the person asks for contact details, and say how many credits it used. Every row says which contacts are on file either way (contacts_on_file).
include_staffingNoAlso return professional employer organizations and staffing firms. They are left out by default: their staff counts hold their clients' workers, so they lead every sector by size without being employers of that size.
with_owner_contactNoOnly companies whose records name an owner or officer (an owner, member, partner, officer, principal, manager or governor on a state register) and give the company's phone or e-mail.
with_person_contactNoOnly companies whose records give a named person's own work e-mail or phone: the employer's point of contact on its Department of Labor labor certification filings, with their job title.
max_years_in_businessNoFewer than this many years since the formation date. Only companies with a formation date match.
min_years_in_businessNoAt least this many years since the state register's formation date. Only companies with a formation date match.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / include_contacts
      Added value: +{
      +  "default": false,
      +  "description": "Also return each company's phone and e-mail, and a named person's own work e-mail or phone, in its row. Each company whose contact is opened uses one credit from the account's monthly allowance, the same credits a person's contact uses; a company with no contact on file costs nothing, and one already opened this month is free. Use it only when the person asks for contact details, and say how many credits it used. Every row says which contacts are on file either way (contacts_on_file).",
      +  "type": "boolean"
      +}
    • removedInput schema / properties / show_contacts
      Removed value: -{
      -  "default": true,
      -  "description": "Each company's phone and e-mail, and each named person's own work e-mail or phone, in its row. On unless set to false. They cost no credit.",
      -  "type": "boolean"
      -}
  2. Changed8 schema fields changed
    • addedInput schema / properties / naics / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "maxItems": 12,
      +    "minItems": 1,
      +    "type": "array"
      +  }
      +]
    • changedInput schema / properties / naics / description
      Previous value: -"A NAICS code, 2 to 6 digits, matched as the start of each company's code: 23 is construction, 2382 building equipment contractors, 238220 plumbing and HVAC contractors. 31-33, 44-45 and 48-49 are the sectors that span codes."New value: +"One NAICS code, or a list of up to 12 searched together in this one call: [\"237130\", \"238910\", \"237990\"]. Each is 2 to 6 digits, matched as the start of a company's code: 23 is construction, 2382 building equipment contractors, 238220 plumbing and HVAC contractors. To choose codes from a description, call find_naics first."
    • removedInput schema / properties / naics / type
      Removed value: -"string"
    • addedInput schema / properties / show_contacts
      Added value: +{
      +  "default": true,
      +  "description": "Each company's phone and e-mail, and each named person's own work e-mail or phone, in its row. On unless set to false. They cost no credit.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / state / anyOf
      Added value: +[
      +  {
      +    "pattern": "^[A-Za-z]{2}$",
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "pattern": "^[A-Za-z]{2}$",
      +      "type": "string"
      +    },
      +    "maxItems": 20,
      +    "minItems": 1,
      +    "type": "array"
      +  }
      +]
    • changedInput schema / properties / state / description
      Previous value: -"The company's state, as a two-letter code."New value: +"One state, or a list of up to 20 searched together in this one call, as two-letter codes: [\"TX\", \"LA\", \"OK\"]."
    • removedInput schema / properties / state / pattern
      Removed value: -"^[A-Za-z]{2}$"
    • removedInput schema / properties / state / type
      Removed value: -"string"
  3. Changed3 schema fields changed
    • addedInput schema / properties / include_staffing
      Added value: +{
      +  "default": false,
      +  "description": "Also return professional employer organizations and staffing firms. They are left out by default: their staff counts hold their clients' workers, so they lead every sector by size without being employers of that size.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / owner_as_filed
      Added value: +{
      +  "default": false,
      +  "description": "Only companies where a state register files someone as an owner, member or partner (never an officer, a director or a plan signer).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / with_person_contact
      Added value: +{
      +  "default": false,
      +  "description": "Only companies whose records give a named person's own work e-mail or phone: the employer's point of contact on its Department of Labor labor certification filings, with their job title.",
      +  "type": "boolean"
      +}
  4. Added

TDQS

A4.5/5.0
Behavior5/5

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

Annotations already declare readOnly/idempotent/non-destructive/closed-world, yet the description still adds substantial behavior: the exact returned fields, default ordering (most staff first), credit consumption per company opened with the free cases (no contact on file, already opened this month), and the rationale for excluding staffing firms by default. This is context the annotations cannot supply.

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?

Front-loaded and information-dense, but delivered as one sprawling sentence chain with semicolons that is hard to scan. The content mostly earns its place, though the return-field inventory duplicates what the schema and result behavior already imply.

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?

For a 17-parameter, zero-required, no-output-schema tool, the description covers what comes back (counts, code split, per-company fields, sort order) and the cost model. Nothing an agent needs in order to call it correctly is missing.

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 coverage is 100%, so the schema already carries parameter meaning; the description largely restates the same filters in prose (staff definition, PPP minimums, owner/officer distinctions). It adds only marginal gloss beyond the schema, so the baseline 3 is appropriate rather than a higher score.

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 specific verb and resource ('Find private companies in the Corridome database in one call') and immediately distinguishes the batch semantics: one NAICS code or a list searched together, one state or a list. It also names a sibling (find_naics) for code resolution, so an agent can tell it apart from search/list_companies without opening a schema.

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?

Explicit routing rules are given: 'Never search one code or one state at a time when the request names several: give them as lists' and 'To choose codes from a description, call find_naics first.' It also gates the paid flag with 'Use it only when the person asks for contact details, and say how many credits it used.' Both when-to-use and when-not are covered.

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