Skip to main content
Glama

companies

Read-only

Search and filter company records by keyword, exact domain, HQ country, industry group, NAICS code, employee-count bucket, or founded-year range. Costs one credit per returned record.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum records to return (1-100). Each returned record costs one credit.
sinceNoReturn companies created/updated on or after this date (YYYY-MM-DD) or ISO-8601 timestamp.
cursorNoOpaque pagination cursor returned as pagination.nextCursor on the previous page.
domainNoExact company domain.
searchNoKeyword search over name, domain, and description.
countriesNoHeadquarters country codes (ISO alpha-2, OR). Pass "unknown" to include companies with no country on file.
naicsCodeNoNAICS 2022 code. Matches the code and everything beneath it, so "51" also returns 5132 and 5173. Sector ranges work: "31-33" returns all manufacturing. Pass "unknown" for unclassified companies. Any 2- to 6-digit code is accepted; codes deeper than we classify (e.g. 541511) match at their deepest classified parent (5415).
includeTotalNoAlso return pagination.total, the number of records matching these filters across all pages. Costs no credits.
foundedYearMaxNoMaximum founded year.
foundedYearMinNoMinimum founded year.
industryGroupsNoCompany industry groups (OR). LinkedIn industry labels, matched case-insensitively; older LinkedIn names and short forms like "software" map to the current label. Pass "unknown" for companies with no industry on file.
employeeCountBucketsNoLinkedIn employee count buckets (OR), e.g. 51-200. Pass "unknown" for no headcount.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedInput schema / properties / includeTotal
      Added value: +{
      +  "description": "Also return pagination.total, the number of records matching these filters across all pages. Costs no credits.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / industryGroups / description
      Previous value: -"Company industry groups (OR). Matched literally against the LinkedIn labels. Pass \"unknown\" for companies with no industry on file."New value: +"Company industry groups (OR). LinkedIn industry labels, matched case-insensitively; older LinkedIn names and short forms like \"software\" map to the current label. Pass \"unknown\" for companies with no industry on file."
    • changedInput schema / properties / naicsCode / description
      Previous value: -"NAICS 2022 code. Matches the code and everything beneath it, so \"51\" also returns 5132 and 5173. Sector ranges work: \"31-33\" returns all manufacturing. Pass \"unknown\" for unclassified companies."New value: +"NAICS 2022 code. Matches the code and everything beneath it, so \"51\" also returns 5132 and 5173. Sector ranges work: \"31-33\" returns all manufacturing. Pass \"unknown\" for unclassified companies. Any 2- to 6-digit code is accepted; codes deeper than we classify (e.g. 541511) match at their deepest classified parent (5415)."
    • removedInput schema / properties / naicsCode / enum
      Removed value: -[
      -  "11",
      -  "21",
      -  "22",
      -  "23",
      -  "42",
      -  "51",
      -  "52",
      -  "53",
      -  "54",
      -  "56",
      -  "71",
      -  "81",
      -  "92",
      -  "111",
      -  "113",
      -  "114",
      -  "212",
      -  "236",
      -  "238",
      -  "311",
      -  "313",
      -  "315",
      -  "316",
      -  "321",
      -  "322",
      -  "323",
      -  "325",
      -  "327",
      -  "331",
      -  "332",
      -  "335",
      -  "336",
      -  "337",
      -  "458",
      -  "482",
      -  "483",
      -  "484",
      -  "485",
      -  "493",
      -  "519",
      -  "532",
      -  "562",
      -  "611",
      -  "621",
      -  "622",
      -  "623",
      -  "712",
      -  "721",
      -  "722",
      -  "811",
      -  "812",
      -  "813",
      -  "1114",
      -  "2111",
      -  "2211",
      -  "2213",
      -  "2361",
      -  "2382",
      -  "3111",
      -  "3115",
      -  "3116",
      -  "3117",
      -  "3118",
      -  "3121",
      -  "3122",
      -  "3162",
      -  "3222",
      -  "3253",
      -  "3254",
      -  "3255",
      -  "3256",
      -  "3261",
      -  "3272",
      -  "3323",
      -  "3325",
      -  "3328",
      -  "3331",
      -  "3332",
      -  "3334",
      -  "3341",
      -  "3342",
      -  "3343",
      -  "3344",
      -  "3345",
      -  "3351",
      -  "3352",
      -  "3353",
      -  "3359",
      -  "3361",
      -  "3363",
      -  "3364",
      -  "3365",
      -  "3366",
      -  "3372",
      -  "3391",
      -  "3399",
      -  "4231",
      -  "4233",
      -  "4234",
      -  "4235",
      -  "4236",
      -  "4238",
      -  "4244",
      -  "4245",
      -  "4246",
      -  "4247",
      -  "4248",
      -  "4411",
      -  "4441",
      -  "4451",
      -  "4491",
      -  "4561",
      -  "4571",
      -  "4591",
      -  "4593",
      -  "4811",
      -  "4851",
      -  "4853",
      -  "4921",
      -  "5121",
      -  "5122",
      -  "5131",
      -  "5132",
      -  "5161",
      -  "5162",
      -  "5173",
      -  "5192",
      -  "5221",
      -  "5231",
      -  "5239",
      -  "5241",
      -  "5242",
      -  "5311",
      -  "5312",
      -  "5322",
      -  "5411",
      -  "5412",
      -  "5413",
      -  "5414",
      -  "5415",
      -  "5416",
      -  "5417",
      -  "5418",
      -  "5419",
      -  "5511",
      -  "5613",
      -  "5614",
      -  "5615",
      -  "5616",
      -  "5617",
      -  "5621",
      -  "6111",
      -  "6113",
      -  "6114",
      -  "6115",
      -  "6213",
      -  "6214",
      -  "6215",
      -  "6216",
      -  "6241",
      -  "6242",
      -  "6244",
      -  "7111",
      -  "7112",
      -  "7115",
      -  "7132",
      -  "7139",
      -  "7225",
      -  "8111",
      -  "8121",
      -  "8123",
      -  "8129",
      -  "8131",
      -  "8132",
      -  "8134",
      -  "8139",
      -  "9211",
      -  "9221",
      -  "9281",
      -  "unknown",
      -  "31-33",
      -  "44-45",
      -  "48-49"
      -]
  2. Changed1 schema field changed
    • changedInput schema / properties / countries / items / enum
      Previous value: -[
      -  "unknown",
      -  "AD",
      -  "AE",
      -  "AF",
      -  "AG",
      -  "AL",
      -  "AM",
      -  "AO",
      -  "AR",
      -  "AT",
      -  "AU",
      -  "AZ",
      -  "BA",
      -  "BB",
      -  "BD",
      -  "BE",
      -  "BF",
      -  "BG",
      -  "BH",
      -  "BI",
      -  "BJ",
      -  "BM",
      -  "BN",
      -  "BO",
      -  "BR",
      -  "BS",
      -  "BT",
      -  "BW",
      -  "BY",
      -  "BZ",
      -  "CA",
      -  "CD",
      -  "CF",
      -  "CG",
      -  "CH",
      -  "CI",
      -  "CL",
      -  "CM",
      -  "CN",
      -  "CO",
      -  "CR",
      -  "CU",
      -  "CV",
      -  "CY",
      -  "CZ",
      -  "DE",
      -  "DJ",
      -  "DK",
      -  "DM",
      -  "DO",
      -  "DZ",
      -  "EC",
      -  "EE",
      -  "EG",
      -  "ER",
      -  "ES",
      -  "ET",
      -  "FI",
      -  "FJ",
      -  "FM",
      -  "FR",
      -  "GA",
      -  "GB",
      -  "GD",
      -  "GE",
      -  "GG",
      -  "GH",
      -  "GI",
      -  "GM",
      -  "GN",
      -  "GQ",
      -  "GR",
      -  "GT",
      -  "GW",
      -  "GY",
      -  "HK",
      -  "HN",
      -  "HR",
      -  "HT",
      -  "HU",
      -  "ID",
      -  "IE",
      -  "IL",
      -  "IM",
      -  "IN",
      -  "IQ",
      -  "IR",
      -  "IS",
      -  "IT",
      -  "JE",
      -  "JM",
      -  "JO",
      -  "JP",
      -  "KE",
      -  "KG",
      -  "KH",
      -  "KI",
      -  "KM",
      -  "KN",
      -  "KP",
      -  "KR",
      -  "KW",
      -  "KY",
      -  "KZ",
      -  "LA",
      -  "LB",
      -  "LC",
      -  "LI",
      -  "LK",
      -  "LR",
      -  "LS",
      -  "LT",
      -  "LU",
      -  "LV",
      -  "LY",
      -  "MA",
      -  "MC",
      -  "MD",
      -  "ME",
      -  "MG",
      -  "MH",
      -  "MK",
      -  "ML",
      -  "MM",
      -  "MN",
      -  "MO",
      -  "MR",
      -  "MT",
      -  "MU",
      -  "MV",
      -  "MW",
      -  "MX",
      -  "MY",
      -  "MZ",
      -  "NA",
      -  "NE",
      -  "NG",
      -  "NI",
      -  "NL",
      -  "NO",
      -  "NP",
      -  "NR",
      -  "NZ",
      -  "OM",
      -  "PA",
      -  "PG",
      -  "PH",
      -  "PK",
      -  "PL",
      -  "PR",
      -  "PS",
      -  "PT",
      -  "PW",
      -  "PY",
      -  "QA",
      -  "RO",
      -  "RS",
      -  "RU",
      -  "RW",
      -  "SA",
      -  "SB",
      -  "SC",
      -  "SD",
      -  "SE",
      -  "SG",
      -  "SI",
      -  "SK",
      -  "SL",
      -  "SM",
      -  "SN",
      -  "SO",
      -  "SR",
      -  "SS",
      -  "ST",
      -  "SV",
      -  "SY",
      -  "SZ",
      -  "TD",
      -  "TG",
      -  "TH",
      -  "TJ",
      -  "TL",
      -  "TM",
      -  "TN",
      -  "TO",
      -  "TR",
      -  "TT",
      -  "TV",
      -  "TW",
      -  "TZ",
      -  "UA",
      -  "UG",
      -  "US",
      -  "UY",
      -  "UZ",
      -  "VA",
      -  "VC",
      -  "VE",
      -  "VG",
      -  "VN",
      -  "VU",
      -  "WS",
      -  "YE",
      -  "ZA",
      -  "ZM",
      -  "ZW"
      -]New value: +[
      +  "unknown",
      +  "AD",
      +  "AE",
      +  "AF",
      +  "AG",
      +  "AI",
      +  "AL",
      +  "AM",
      +  "AO",
      +  "AR",
      +  "AS",
      +  "AT",
      +  "AU",
      +  "AW",
      +  "AX",
      +  "AZ",
      +  "BA",
      +  "BB",
      +  "BD",
      +  "BE",
      +  "BF",
      +  "BG",
      +  "BH",
      +  "BI",
      +  "BJ",
      +  "BL",
      +  "BM",
      +  "BN",
      +  "BO",
      +  "BQ",
      +  "BR",
      +  "BS",
      +  "BT",
      +  "BW",
      +  "BY",
      +  "BZ",
      +  "CA",
      +  "CD",
      +  "CF",
      +  "CG",
      +  "CH",
      +  "CI",
      +  "CK",
      +  "CL",
      +  "CM",
      +  "CN",
      +  "CO",
      +  "CR",
      +  "CU",
      +  "CV",
      +  "CW",
      +  "CY",
      +  "CZ",
      +  "DE",
      +  "DJ",
      +  "DK",
      +  "DM",
      +  "DO",
      +  "DZ",
      +  "EC",
      +  "EE",
      +  "EG",
      +  "EH",
      +  "ER",
      +  "ES",
      +  "ET",
      +  "FI",
      +  "FJ",
      +  "FK",
      +  "FM",
      +  "FO",
      +  "FR",
      +  "GA",
      +  "GB",
      +  "GD",
      +  "GE",
      +  "GF",
      +  "GG",
      +  "GH",
      +  "GI",
      +  "GL",
      +  "GM",
      +  "GN",
      +  "GP",
      +  "GQ",
      +  "GR",
      +  "GT",
      +  "GU",
      +  "GW",
      +  "GY",
      +  "HK",
      +  "HN",
      +  "HR",
      +  "HT",
      +  "HU",
      +  "ID",
      +  "IE",
      +  "IL",
      +  "IM",
      +  "IN",
      +  "IQ",
      +  "IR",
      +  "IS",
      +  "IT",
      +  "JE",
      +  "JM",
      +  "JO",
      +  "JP",
      +  "KE",
      +  "KG",
      +  "KH",
      +  "KI",
      +  "KM",
      +  "KN",
      +  "KP",
      +  "KR",
      +  "KW",
      +  "KY",
      +  "KZ",
      +  "LA",
      +  "LB",
      +  "LC",
      +  "LI",
      +  "LK",
      +  "LR",
      +  "LS",
      +  "LT",
      +  "LU",
      +  "LV",
      +  "LY",
      +  "MA",
      +  "MC",
      +  "MD",
      +  "ME",
      +  "MF",
      +  "MG",
      +  "MH",
      +  "MK",
      +  "ML",
      +  "MM",
      +  "MN",
      +  "MO",
      +  "MP",
      +  "MQ",
      +  "MR",
      +  "MS",
      +  "MT",
      +  "MU",
      +  "MV",
      +  "MW",
      +  "MX",
      +  "MY",
      +  "MZ",
      +  "NA",
      +  "NC",
      +  "NE",
      +  "NG",
      +  "NI",
      +  "NL",
      +  "NO",
      +  "NP",
      +  "NR",
      +  "NU",
      +  "NZ",
      +  "OM",
      +  "PA",
      +  "PE",
      +  "PF",
      +  "PG",
      +  "PH",
      +  "PK",
      +  "PL",
      +  "PM",
      +  "PR",
      +  "PS",
      +  "PT",
      +  "PW",
      +  "PY",
      +  "QA",
      +  "RE",
      +  "RO",
      +  "RS",
      +  "RU",
      +  "RW",
      +  "SA",
      +  "SB",
      +  "SC",
      +  "SD",
      +  "SE",
      +  "SG",
      +  "SH",
      +  "SI",
      +  "SK",
      +  "SL",
      +  "SM",
      +  "SN",
      +  "SO",
      +  "SR",
      +  "SS",
      +  "ST",
      +  "SV",
      +  "SX",
      +  "SY",
      +  "SZ",
      +  "TC",
      +  "TD",
      +  "TG",
      +  "TH",
      +  "TJ",
      +  "TK",
      +  "TL",
      +  "TM",
      +  "TN",
      +  "TO",
      +  "TR",
      +  "TT",
      +  "TV",
      +  "TW",
      +  "TZ",
      +  "UA",
      +  "UG",
      +  "US",
      +  "UY",
      +  "UZ",
      +  "VA",
      +  "VC",
      +  "VE",
      +  "VG",
      +  "VI",
      +  "VN",
      +  "VU",
      +  "WF",
      +  "WS",
      +  "YE",
      +  "YT",
      +  "ZA",
      +  "ZM",
      +  "ZW"
      +]
  3. Changed1 schema field changed
    • addedInput schema / properties / countries / items / enum
      Added value: +[
      +  "unknown",
      +  "AD",
      +  "AE",
      +  "AF",
      +  "AG",
      +  "AL",
      +  "AM",
      +  "AO",
      +  "AR",
      +  "AT",
      +  "AU",
      +  "AZ",
      +  "BA",
      +  "BB",
      +  "BD",
      +  "BE",
      +  "BF",
      +  "BG",
      +  "BH",
      +  "BI",
      +  "BJ",
      +  "BM",
      +  "BN",
      +  "BO",
      +  "BR",
      +  "BS",
      +  "BT",
      +  "BW",
      +  "BY",
      +  "BZ",
      +  "CA",
      +  "CD",
      +  "CF",
      +  "CG",
      +  "CH",
      +  "CI",
      +  "CL",
      +  "CM",
      +  "CN",
      +  "CO",
      +  "CR",
      +  "CU",
      +  "CV",
      +  "CY",
      +  "CZ",
      +  "DE",
      +  "DJ",
      +  "DK",
      +  "DM",
      +  "DO",
      +  "DZ",
      +  "EC",
      +  "EE",
      +  "EG",
      +  "ER",
      +  "ES",
      +  "ET",
      +  "FI",
      +  "FJ",
      +  "FM",
      +  "FR",
      +  "GA",
      +  "GB",
      +  "GD",
      +  "GE",
      +  "GG",
      +  "GH",
      +  "GI",
      +  "GM",
      +  "GN",
      +  "GQ",
      +  "GR",
      +  "GT",
      +  "GW",
      +  "GY",
      +  "HK",
      +  "HN",
      +  "HR",
      +  "HT",
      +  "HU",
      +  "ID",
      +  "IE",
      +  "IL",
      +  "IM",
      +  "IN",
      +  "IQ",
      +  "IR",
      +  "IS",
      +  "IT",
      +  "JE",
      +  "JM",
      +  "JO",
      +  "JP",
      +  "KE",
      +  "KG",
      +  "KH",
      +  "KI",
      +  "KM",
      +  "KN",
      +  "KP",
      +  "KR",
      +  "KW",
      +  "KY",
      +  "KZ",
      +  "LA",
      +  "LB",
      +  "LC",
      +  "LI",
      +  "LK",
      +  "LR",
      +  "LS",
      +  "LT",
      +  "LU",
      +  "LV",
      +  "LY",
      +  "MA",
      +  "MC",
      +  "MD",
      +  "ME",
      +  "MG",
      +  "MH",
      +  "MK",
      +  "ML",
      +  "MM",
      +  "MN",
      +  "MO",
      +  "MR",
      +  "MT",
      +  "MU",
      +  "MV",
      +  "MW",
      +  "MX",
      +  "MY",
      +  "MZ",
      +  "NA",
      +  "NE",
      +  "NG",
      +  "NI",
      +  "NL",
      +  "NO",
      +  "NP",
      +  "NR",
      +  "NZ",
      +  "OM",
      +  "PA",
      +  "PG",
      +  "PH",
      +  "PK",
      +  "PL",
      +  "PR",
      +  "PS",
      +  "PT",
      +  "PW",
      +  "PY",
      +  "QA",
      +  "RO",
      +  "RS",
      +  "RU",
      +  "RW",
      +  "SA",
      +  "SB",
      +  "SC",
      +  "SD",
      +  "SE",
      +  "SG",
      +  "SI",
      +  "SK",
      +  "SL",
      +  "SM",
      +  "SN",
      +  "SO",
      +  "SR",
      +  "SS",
      +  "ST",
      +  "SV",
      +  "SY",
      +  "SZ",
      +  "TD",
      +  "TG",
      +  "TH",
      +  "TJ",
      +  "TL",
      +  "TM",
      +  "TN",
      +  "TO",
      +  "TR",
      +  "TT",
      +  "TV",
      +  "TW",
      +  "TZ",
      +  "UA",
      +  "UG",
      +  "US",
      +  "UY",
      +  "UZ",
      +  "VA",
      +  "VC",
      +  "VE",
      +  "VG",
      +  "VN",
      +  "VU",
      +  "WS",
      +  "YE",
      +  "ZA",
      +  "ZM",
      +  "ZW"
      +]
  4. Changed6 schema fields changed
    • addedInput schema / properties / countries
      Added value: +{
      +  "description": "Headquarters country codes (ISO alpha-2, OR). Pass \"unknown\" to include companies with no country on file.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedInput schema / properties / country
      Removed value: -{
      -  "description": "Headquarters country code (ISO alpha-2).",
      -  "type": "string"
      -}
    • removedInput schema / properties / employeeCountBucket
      Removed value: -{
      -  "description": "LinkedIn employee count bucket, e.g. 51-200.",
      -  "type": "string"
      -}
    • addedInput schema / properties / employeeCountBuckets
      Added value: +{
      +  "description": "LinkedIn employee count buckets (OR), e.g. 51-200. Pass \"unknown\" for no headcount.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedInput schema / properties / industryGroup
      Removed value: -{
      -  "description": "Company industry group.",
      -  "type": "string"
      -}
    • addedInput schema / properties / industryGroups
      Added value: +{
      +  "description": "Company industry groups (OR). Matched literally against the LinkedIn labels. Pass \"unknown\" for companies with no industry on file.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  5. Changed1 schema field changed
    • addedInput schema / properties / naicsCode / enum
      Added value: +[
      +  "11",
      +  "21",
      +  "22",
      +  "23",
      +  "42",
      +  "51",
      +  "52",
      +  "53",
      +  "54",
      +  "56",
      +  "71",
      +  "81",
      +  "92",
      +  "111",
      +  "113",
      +  "114",
      +  "212",
      +  "236",
      +  "238",
      +  "311",
      +  "313",
      +  "315",
      +  "316",
      +  "321",
      +  "322",
      +  "323",
      +  "325",
      +  "327",
      +  "331",
      +  "332",
      +  "335",
      +  "336",
      +  "337",
      +  "458",
      +  "482",
      +  "483",
      +  "484",
      +  "485",
      +  "493",
      +  "519",
      +  "532",
      +  "562",
      +  "611",
      +  "621",
      +  "622",
      +  "623",
      +  "712",
      +  "721",
      +  "722",
      +  "811",
      +  "812",
      +  "813",
      +  "1114",
      +  "2111",
      +  "2211",
      +  "2213",
      +  "2361",
      +  "2382",
      +  "3111",
      +  "3115",
      +  "3116",
      +  "3117",
      +  "3118",
      +  "3121",
      +  "3122",
      +  "3162",
      +  "3222",
      +  "3253",
      +  "3254",
      +  "3255",
      +  "3256",
      +  "3261",
      +  "3272",
      +  "3323",
      +  "3325",
      +  "3328",
      +  "3331",
      +  "3332",
      +  "3334",
      +  "3341",
      +  "3342",
      +  "3343",
      +  "3344",
      +  "3345",
      +  "3351",
      +  "3352",
      +  "3353",
      +  "3359",
      +  "3361",
      +  "3363",
      +  "3364",
      +  "3365",
      +  "3366",
      +  "3372",
      +  "3391",
      +  "3399",
      +  "4231",
      +  "4233",
      +  "4234",
      +  "4235",
      +  "4236",
      +  "4238",
      +  "4244",
      +  "4245",
      +  "4246",
      +  "4247",
      +  "4248",
      +  "4411",
      +  "4441",
      +  "4451",
      +  "4491",
      +  "4561",
      +  "4571",
      +  "4591",
      +  "4593",
      +  "4811",
      +  "4851",
      +  "4853",
      +  "4921",
      +  "5121",
      +  "5122",
      +  "5131",
      +  "5132",
      +  "5161",
      +  "5162",
      +  "5173",
      +  "5192",
      +  "5221",
      +  "5231",
      +  "5239",
      +  "5241",
      +  "5242",
      +  "5311",
      +  "5312",
      +  "5322",
      +  "5411",
      +  "5412",
      +  "5413",
      +  "5414",
      +  "5415",
      +  "5416",
      +  "5417",
      +  "5418",
      +  "5419",
      +  "5511",
      +  "5613",
      +  "5614",
      +  "5615",
      +  "5616",
      +  "5617",
      +  "5621",
      +  "6111",
      +  "6113",
      +  "6114",
      +  "6115",
      +  "6213",
      +  "6214",
      +  "6215",
      +  "6216",
      +  "6241",
      +  "6242",
      +  "6244",
      +  "7111",
      +  "7112",
      +  "7115",
      +  "7132",
      +  "7139",
      +  "7225",
      +  "8111",
      +  "8121",
      +  "8123",
      +  "8129",
      +  "8131",
      +  "8132",
      +  "8134",
      +  "8139",
      +  "9211",
      +  "9221",
      +  "9281",
      +  "unknown",
      +  "31-33",
      +  "44-45",
      +  "48-49"
      +]
  6. Changed1 schema field changed
    • addedInput schema / properties / naicsCode
      Added value: +{
      +  "description": "NAICS 2022 code. Matches the code and everything beneath it, so \"51\" also returns 5132 and 5173. Sector ranges work: \"31-33\" returns all manufacturing. Pass \"unknown\" for unclassified companies.",
      +  "type": "string"
      +}
  7. Changed1 schema field changed
    • changedInput schema / properties / since / description
      Previous value: -"Return companies created/updated after this ISO-8601 timestamp."New value: +"Return companies created/updated on or after this date (YYYY-MM-DD) or ISO-8601 timestamp."
  8. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=true, so safety is covered. The description adds genuinely useful non-annotated context: the one-credit-per-returned-record billing model, which directly affects how aggressively an agent should page. It omits auth requirements and rate-limit 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 with zero filler. The filter capabilities come first and the cost constraint, the most decision-relevant behavioral fact, is front-loaded in the second sentence.

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?

There is no output schema, so the description carries the burden of describing what a returned record contains, and it never says. Cost and pagination cursor semantics are only partially covered (cursor exists in the schema), and the record shape, sorting, and stability of results are unaddressed for a 12-parameter search tool.

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%, so the schema already documents all 12 parameters thoroughly (including NAICS prefix matching and 'unknown' sentinels). The description only restates the filter categories at a high level and adds no syntax or format detail beyond the schema, so the baseline 3 applies.

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?

States a specific verb pair (search and filter) plus the resource (company records) and enumerates the filter dimensions, so the agent knows exactly what it gets. It does not distinguish itself from siblings like acquisitions or funding_events, but those operate on different resources, so the risk of confusion is low.

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

Usage Guidelines3/5

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

Usage is only implied: an agent can infer it should call this when it needs company records, but there is no explicit when-to-use, when-not-to, or named alternative. Sibling tools are not referenced at all, leaving routing decisions to inference.

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