Skip to main content
Glama

Find Companies By Tech Stack

find_companies_by_tech_stack

Use ONLY when the user explicitly wants to discover companies BY THEIR INSTALLED TECHNOLOGY — e.g. "find DTC brands using Shopify and Klaviyo", "who runs Snowflake AND Looker", "US e-commerce companies using HubSpot". For hiring-signal discovery (companies posting jobs that mention a tech), use theirstack_search instead — that surfaces investment intent, whereas this surfaces installed base.

That installed base is what TheirStack DETECTS from job-posting text, not from crawling storefronts, so it only sees companies that hire and name the tool in their JDs — treat a company's absence as "not detected here," not "not using it" (a storefront-sniffing method like BuiltWith/Wappalyzer would surface more).

For ecommerce-platform tools, results may include the platform's SERVICE PROVIDERS (agencies, ISVs) alongside actual merchants — job mentions don't distinguish "we run on Shopify" from "we sell to Shopify merchants," so name the kind of company you want in criteria and the check filters them out. Recruiting agencies are always excluded (company_type = direct_employer), matching theirstack_search.

Costs 1.5 Sliq credits per company returned; a failed search is free.

In chat, STATE THE COUNT AND THE COST in the same reply as the results — every time, without stopping to ask first. Use the user's number when they gave one, otherwise the default: "pulled 25 companies — 37.5 credits; say if you want more, max 100." Price the companies actually returned, which count gives: fewer than limit costs less. Because this endpoint pages, prefer one page at the user's number over silently walking offset past it — every extra page is more credits.

Each company returned is then checked against criteria, one company at a time, reading its name, firmographics and technologies, and only the matches come back in companies; the rest come back in rejected as {name, reason}. It adds a few seconds per ten companies.

When this runs in an agent, every company with a domain is saved to the Output tab as a company row (deduped by domain) with its verdict, carrying its firmographics and matched technologies; the rejected ones are hidden from the list's default view.

The tool resolves each technology name to a TheirStack catalog slug (calling /v0/catalog/technologies per name; popularity tiebreak; exact name match wins), then queries /v1/companies/search with company_technology_slug_and so EVERY supplied technology must be present on the returned company. { "companies": [ { "id": str, "name": str, "domain": str | None, "industry": str | None, "employee_count": int | None, "country_code": str | None, "linkedin_url": str | None, "technologies_found": [ {"slug": str, "name": str, "confidence": str, "jobs": int, "last_date_found": str}, ... ], "verdict": str | None, # 'qualified', 'unclear', or None when the check couldn't run "verdict_reason": str, }, ... ], "rejected": [{"name": str, "reason": str}, ...], # companies the check turned down "count": int, # companies in this page, rejected ones included; the number billed "total_matches": int, # universe size for this query (or None) "created_identifiers": [str], # domains of matching companies this call newly added to the list }

On upstream failure (timeout / 5xx / connection error), returns {"companies": [], "count": 0, "theirstack_available": False} so the agent can read the flag and degrade gracefully.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoCompanies this ONE call returns, 1-100 (values outside are clamped), default 25. Pass the user's number when they named one.
offsetNoNumber of results to skip for pagination. Pass `limit`, 2*`limit`, ... to fetch subsequent pages. Re-run with the same filters to get a stable order. Each page is billed like a fresh pull, so page only when the user asked for more.
agent_idNoOptional — a specific agent to save the companies into. Omit it to use the running agent, which is the usual case.
criteriaYesWhat makes a company a match for this search, in plain words: the kind of company you're looking for (e.g. "Consumer brands that sell through their own Shopify store, not agencies or app developers"). Each company returned is checked against it, and the check reads nothing else of your instructions, so make it no narrower than what this call searches for. A role that is part of the signal belongs here; who you'll contact at a matching company doesn't, since the check reads that as a rule about which companies match.
industryNoIndustries the company must match, picked from this parameter's list of TheirStack industry names (e.g. ["Retail", "Higher Education"]). A name also matches its sub-industries: "Manufacturing" covers "Motor Vehicle Manufacturing". Some parents are broad ("Consumer Services" includes non-profits and religious institutions), so name a parent only when all of it fits and list specific industries otherwise.
list_nameNoShort kebab slug naming the Output-tab list bucket (e.g. 'shopify-brands'). Absent, companies land in the 'default' list.
confidenceNoTheirStack tech-detection confidence band. Pass ["high", "medium"] to drop one-off / stale mentions. Defaults to None (all confidence levels). Valid values: "high", "medium", "low". If a confidence-filtered search returns zero matches for a technology that plausibly has users, retry without `confidence` and judge per-company strength from `technologies_found[].confidence` instead — TheirStack's confidence aggregates are intermittently incomplete for some technologies.
company_cityNoCity/state substrings the company HQ must match (e.g. ["Atlanta", "Chicago", "Washington"]). Case-insensitive substring match, OR-combined across the list. Do NOT include the `(?i)` flag — TheirStack rejects it on this field. Pair with `country_codes` to keep matches scoped.
on_behalf_ofNoAn agency client's email, from list_agency_clients, to run this call in that client's account: their agents, settings, connected accounts, and credits. Omit it to act on your own account.
technologiesYesHuman product names — e.g. ["Shopify", "Klaviyo"]. Use canonical product names; names with no catalog match raise ModelRetry, and ambiguous names resolve to the most popular match. AND semantics: the company must use ALL supplied technologies. Max 10 per call.
country_codesNoISO alpha-2 HQ country filter. Pass ["US"] to scope to US companies — usually the right default.
min_revenue_usdNoMinimum company annual revenue in USD (e.g. 10_000_000 for $10M+).
industry_excludesNoIndustries to exclude, sub-industries included, from the same list as `industry`.
max_employee_countNoMaximum company headcount. Defaults to None; consider passing e.g. 5000 if "uses Shopify" alone returns 10K+ matches dominated by enterprise outliers.
min_employee_countNoMinimum company headcount.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / on_behalf_of
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "An agency client's email, from list_agency_clients, to run this call in that client's account: their agents, settings, connected accounts, and credits. Omit it to act on your own account."
      +}
  2. Changed2 schema fields changed
    • addedInput schema / properties / criteria
      Added value: +{
      +  "description": "What makes a company a match for this search, in plain words:\nthe kind of company you're looking for (e.g. \"Consumer brands that\nsell through their own Shopify store, not agencies or app\ndevelopers\"). Each company returned is checked against it, and the\ncheck reads nothing else of your instructions, so make it no\nnarrower than what this call searches for. A role that is part of\nthe signal belongs here; who you'll contact at a matching company\ndoesn't, since the check reads that as a rule about which companies\nmatch.",
      +  "minLength": 1,
      +  "type": "string"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "technologies"
      -]New value: +[
      +  "technologies",
      +  "criteria"
      +]
  3. Changed4 schema fields changed
    • changedInput schema / properties / industry / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "enum": [
      +        "Abrasives and Nonmetallic Minerals Manufacturing",
      +        "Accessible Architecture and Design",
      +        "Accessible Hardware Manufacturing",
      +        "Accommodation Services",
      +        "Accounting",
      +        "Administration of Justice",
      +        "Administrative and Support Services",
      +        "Advertising Services",
      +        "Agricultural Chemical Manufacturing",
      +        "Agriculture, Construction, Mining Machinery Manufacturing",
      +        "Air, Water, and Waste Program Management",
      +        "Airlines and Aviation",
      +        "Alternative Dispute Resolution",
      +        "Alternative Fuel Vehicle Manufacturing",
      +        "Alternative Medicine",
      +        "Ambulance Services",
      +        "Amusement Parks and Arcades",
      +        "Animal Feed Manufacturing",
      +        "Animation and Post-production",
      +        "Apparel Manufacturing",
      +        "Appliances, Electrical, and Electronics Manufacturing",
      +        "Architectural and Structural Metal Manufacturing",
      +        "Architecture and Planning",
      +        "Armed Forces",
      +        "Artificial Rubber and Synthetic Fiber Manufacturing",
      +        "Artists and Writers",
      +        "Audio and Video Equipment Manufacturing",
      +        "Automation Machinery Manufacturing",
      +        "Aviation and Aerospace Component Manufacturing",
      +        "Baked Goods Manufacturing",
      +        "Banking",
      +        "Bars, Taverns, and Nightclubs",
      +        "Bed-and-Breakfasts, Hostels, Homestays",
      +        "Beverage Manufacturing",
      +        "Biomass Electric Power Generation",
      +        "Biotechnology Research",
      +        "Blockchain Services",
      +        "Blogs",
      +        "Boilers, Tanks, and Shipping Container Manufacturing",
      +        "Book Publishing",
      +        "Book and Periodical Publishing",
      +        "Breweries",
      +        "Broadcast Media Production and Distribution",
      +        "Building Construction",
      +        "Building Equipment Contractors",
      +        "Building Finishing Contractors",
      +        "Building Structure and Exterior Contractors",
      +        "Business Consulting and Services",
      +        "Business Content",
      +        "Business Intelligence Platforms",
      +        "Cable and Satellite Programming",
      +        "Capital Markets",
      +        "Caterers",
      +        "Chemical Manufacturing",
      +        "Chemical Raw Materials Manufacturing",
      +        "Child Day Care Services",
      +        "Chiropractors",
      +        "Circuses and Magic Shows",
      +        "Civic and Social Organizations",
      +        "Civil Engineering",
      +        "Claims Adjusting, Actuarial Services",
      +        "Clay and Refractory Products Manufacturing",
      +        "Climate Data and Analytics",
      +        "Climate Technology Product Manufacturing",
      +        "Coal Mining",
      +        "Collection Agencies",
      +        "Commercial and Industrial Equipment Rental",
      +        "Commercial and Industrial Machinery Maintenance",
      +        "Commercial and Service Industry Machinery Manufacturing",
      +        "Communications Equipment Manufacturing",
      +        "Community Development and Urban Planning",
      +        "Community Services",
      +        "Computer Games",
      +        "Computer Hardware Manufacturing",
      +        "Computer Networking Products",
      +        "Computer and Network Security",
      +        "Computers and Electronics Manufacturing",
      +        "Conservation Programs",
      +        "Construction",
      +        "Construction Hardware Manufacturing",
      +        "Consumer Goods Rental",
      +        "Consumer Services",
      +        "Correctional Institutions",
      +        "Cosmetology and Barber Schools",
      +        "Courts of Law",
      +        "Credit Intermediation",
      +        "Cutlery and Handtool Manufacturing",
      +        "Dairy Product Manufacturing",
      +        "Dance Companies",
      +        "Data Infrastructure and Analytics",
      +        "Data Security Software Products",
      +        "Defense and Space Manufacturing",
      +        "Dentists",
      +        "Design Services",
      +        "Desktop Computing Software Products",
      +        "Digital Accessibility Services",
      +        "Distilleries",
      +        "E-Learning Providers",
      +        "Economic Programs",
      +        "Education",
      +        "Education Administration Programs",
      +        "Electric Lighting Equipment Manufacturing",
      +        "Electric Power Generation",
      +        "Electric Power Transmission, Control, and Distribution",
      +        "Electrical Equipment Manufacturing",
      +        "Electronic and Precision Equipment Maintenance",
      +        "Embedded Software Products",
      +        "Emergency and Relief Services",
      +        "Engineering Services",
      +        "Engines and Power Transmission Equipment Manufacturing",
      +        "Entertainment Providers",
      +        "Environmental Quality Programs",
      +        "Environmental Services",
      +        "Equipment Rental Services",
      +        "Events Services",
      +        "Executive Offices",
      +        "Executive Search Services",
      +        "Fabricated Metal Products",
      +        "Facilities Services",
      +        "Family Planning Centers",
      +        "Farming",
      +        "Farming, Ranching, Forestry",
      +        "Fashion Accessories Manufacturing",
      +        "Financial Services",
      +        "Fine Arts Schools",
      +        "Fire Protection",
      +        "Fisheries",
      +        "Flight Training",
      +        "Food and Beverage Manufacturing",
      +        "Food and Beverage Retail",
      +        "Food and Beverage Services",
      +        "Footwear Manufacturing",
      +        "Footwear and Leather Goods Repair",
      +        "Forestry and Logging",
      +        "Fossil Fuel Electric Power Generation",
      +        "Freight and Package Transportation",
      +        "Fruit and Vegetable Preserves Manufacturing",
      +        "Fuel Cell Manufacturing",
      +        "Fundraising",
      +        "Funds and Trusts",
      +        "Furniture and Home Furnishings Manufacturing",
      +        "Gambling Facilities and Casinos",
      +        "Geothermal Electric Power Generation",
      +        "Glass Product Manufacturing",
      +        "Glass, Ceramics and Concrete Manufacturing",
      +        "Golf Courses and Country Clubs",
      +        "Government Administration",
      +        "Government Relations Services",
      +        "Graphic Design",
      +        "Ground Passenger Transportation",
      +        "HVAC and Refrigeration Equipment Manufacturing",
      +        "Health and Human Services",
      +        "Higher Education",
      +        "Highway, Street, and Bridge Construction",
      +        "Historical Sites",
      +        "Holding Companies",
      +        "Home Health Care Services",
      +        "Horticulture",
      +        "Hospitality",
      +        "Hospitals",
      +        "Hospitals and Health Care",
      +        "Hotels and Motels",
      +        "Household Appliance Manufacturing",
      +        "Household Services",
      +        "Household and Institutional Furniture Manufacturing",
      +        "Housing Programs",
      +        "Housing and Community Development",
      +        "Human Resources Services",
      +        "Hydroelectric Power Generation",
      +        "IT Services and IT Consulting",
      +        "IT System Custom Software Development",
      +        "IT System Data Services",
      +        "IT System Design Services",
      +        "IT System Installation and Disposal",
      +        "IT System Operations and Maintenance",
      +        "IT System Testing and Evaluation",
      +        "IT System Training and Support",
      +        "Individual and Family Services",
      +        "Industrial Machinery Manufacturing",
      +        "Industry Associations",
      +        "Information Services",
      +        "Insurance",
      +        "Insurance Agencies and Brokerages",
      +        "Insurance Carriers",
      +        "Insurance and Employee Benefit Funds",
      +        "Interior Design",
      +        "International Affairs",
      +        "International Trade and Development",
      +        "Internet Marketplace Platforms",
      +        "Internet News",
      +        "Internet Publishing",
      +        "Interurban and Rural Bus Services",
      +        "Investment Advice",
      +        "Investment Banking",
      +        "Investment Management",
      +        "Janitorial Services",
      +        "Landscaping Services",
      +        "Language Schools",
      +        "Laundry and Drycleaning Services",
      +        "Law Enforcement",
      +        "Law Practice",
      +        "Leasing Non-residential Real Estate",
      +        "Leasing Residential Real Estate",
      +        "Leather Product Manufacturing",
      +        "Legal Services",
      +        "Legislative Offices",
      +        "Libraries",
      +        "Lime and Gypsum Products Manufacturing",
      +        "Loan Brokers",
      +        "Machinery Manufacturing",
      +        "Magnetic and Optical Media Manufacturing",
      +        "Manufacturing",
      +        "Maritime Transportation",
      +        "Market Research",
      +        "Marketing Services",
      +        "Mattress and Blinds Manufacturing",
      +        "Measuring and Control Instrument Manufacturing",
      +        "Meat Products Manufacturing",
      +        "Media & Telecommunications",
      +        "Media Production",
      +        "Medical Equipment Manufacturing",
      +        "Medical Practices",
      +        "Medical and Diagnostic Laboratories",
      +        "Mental Health Care",
      +        "Metal Ore Mining",
      +        "Metal Treatments",
      +        "Metal Valve, Ball, and Roller Manufacturing",
      +        "Metalworking Machinery Manufacturing",
      +        "Military and International Affairs",
      +        "Mining",
      +        "Mobile Computing Software Products",
      +        "Mobile Food Services",
      +        "Mobile Gaming Apps",
      +        "Motor Vehicle Manufacturing",
      +        "Motor Vehicle Parts Manufacturing",
      +        "Movies and Sound Recording",
      +        "Movies, Videos and Sound",
      +        "Museums",
      +        "Museums, Historical Sites, and Zoos",
      +        "Musicians",
      +        "Nanotechnology Research",
      +        "Natural Gas Distribution",
      +        "Natural Gas Extraction",
      +        "Newspaper Publishing",
      +        "Non-profit Organizations",
      +        "Nonmetallic Mineral Mining",
      +        "Nonresidential Building Construction",
      +        "Nuclear Electric Power Generation",
      +        "Nursing Homes and Residential Care Facilities",
      +        "Office Administration",
      +        "Office Furniture and Fixtures Manufacturing",
      +        "Oil Extraction",
      +        "Oil and Coal Product Manufacturing",
      +        "Oil and Gas",
      +        "Oil, Gas, and Mining",
      +        "Online Audio and Video Media",
      +        "Online and Mail Order Retail",
      +        "Operations Consulting",
      +        "Optometrists",
      +        "Outpatient Care Centers",
      +        "Outsourcing and Offshoring Consulting",
      +        "Packaging and Containers Manufacturing",
      +        "Paint, Coating, and Adhesive Manufacturing",
      +        "Paper and Forest Product Manufacturing",
      +        "Pension Funds",
      +        "Performing Arts",
      +        "Performing Arts and Spectator Sports",
      +        "Periodical Publishing",
      +        "Personal Care Product Manufacturing",
      +        "Personal Care Services",
      +        "Personal and Laundry Services",
      +        "Pet Services",
      +        "Pharmaceutical Manufacturing",
      +        "Philanthropic Fundraising Services",
      +        "Photography",
      +        "Physical, Occupational and Speech Therapists",
      +        "Physicians",
      +        "Pipeline Transportation",
      +        "Plastics Manufacturing",
      +        "Plastics and Rubber Product Manufacturing",
      +        "Political Organizations",
      +        "Postal Services",
      +        "Primary Metal Manufacturing",
      +        "Primary and Secondary Education",
      +        "Printing Services",
      +        "Professional Organizations",
      +        "Professional Services",
      +        "Professional Training and Coaching",
      +        "Public Assistance Programs",
      +        "Public Health",
      +        "Public Policy Offices",
      +        "Public Relations and Communications Services",
      +        "Public Safety",
      +        "Racetracks",
      +        "Radio and Television Broadcasting",
      +        "Rail Transportation",
      +        "Railroad Equipment Manufacturing",
      +        "Ranching",
      +        "Ranching and Fisheries",
      +        "Real Estate",
      +        "Real Estate Agents and Brokers",
      +        "Real Estate and Equipment Rental Services",
      +        "Recreational Facilities",
      +        "Regenerative Design",
      +        "Religious Institutions",
      +        "Renewable Energy Equipment Manufacturing",
      +        "Renewable Energy Power Generation",
      +        "Renewable Energy Semiconductor Manufacturing",
      +        "Repair and Maintenance",
      +        "Research Services",
      +        "Residential Building Construction",
      +        "Restaurants",
      +        "Retail",
      +        "Retail Apparel and Fashion",
      +        "Retail Appliances, Electrical, and Electronic Equipment",
      +        "Retail Art Dealers",
      +        "Retail Art Supplies",
      +        "Retail Books and Printed News",
      +        "Retail Building Materials and Garden Equipment",
      +        "Retail Florists",
      +        "Retail Furniture and Home Furnishings",
      +        "Retail Gasoline",
      +        "Retail Groceries",
      +        "Retail Health and Personal Care Products",
      +        "Retail Luxury Goods and Jewelry",
      +        "Retail Motor Vehicles",
      +        "Retail Musical Instruments",
      +        "Retail Office Equipment",
      +        "Retail Office Supplies and Gifts",
      +        "Retail Pharmacies",
      +        "Retail Recyclable Materials & Used Merchandise",
      +        "Reupholstery and Furniture Repair",
      +        "Robot Manufacturing",
      +        "Robotics Engineering",
      +        "Rubber Products Manufacturing",
      +        "Satellite Telecommunications",
      +        "Savings Institutions",
      +        "School and Employee Bus Services",
      +        "Seafood Product Manufacturing",
      +        "Secretarial Schools",
      +        "Securities and Commodity Exchanges",
      +        "Security Guards and Patrol Services",
      +        "Security Systems Services",
      +        "Security and Investigations",
      +        "Semiconductor Manufacturing",
      +        "Services for Renewable Energy",
      +        "Services for the Elderly and Disabled",
      +        "Sheet Music Publishing",
      +        "Shipbuilding",
      +        "Shuttles and Special Needs Transportation Services",
      +        "Sightseeing Transportation",
      +        "Skiing Facilities",
      +        "Smart Meter Manufacturing",
      +        "Soap and Cleaning Product Manufacturing",
      +        "Social Networking Platforms",
      +        "Software Development",
      +        "Solar Electric Power Generation",
      +        "Sound Recording",
      +        "Space Research and Technology",
      +        "Specialty Trade Contractors",
      +        "Spectator Sports",
      +        "Sporting Goods Manufacturing",
      +        "Sports Teams and Clubs",
      +        "Sports and Recreation Instruction",
      +        "Spring and Wire Product Manufacturing",
      +        "Staffing and Recruiting",
      +        "Steam and Air-Conditioning Supply",
      +        "Strategic Management Services",
      +        "Subdivision of Land",
      +        "Sugar and Confectionery Product Manufacturing",
      +        "Surveying and Mapping Services",
      +        "Taxi and Limousine Services",
      +        "Technical and Vocational Training",
      +        "Technology, Information and Internet",
      +        "Technology, Information and Media",
      +        "Telecommunications",
      +        "Telecommunications Carriers",
      +        "Telephone Call Centers",
      +        "Temporary Help Services",
      +        "Textile Manufacturing",
      +        "Theater Companies",
      +        "Think Tanks",
      +        "Tobacco Manufacturing",
      +        "Translation and Localization",
      +        "Transportation Equipment Manufacturing",
      +        "Transportation Programs",
      +        "Transportation, Logistics, Supply Chain and Storage",
      +        "Travel Arrangements",
      +        "Truck Transportation",
      +        "Trusts and Estates",
      +        "Turned Products and Fastener Manufacturing",
      +        "Urban Transit Services",
      +        "Utilities",
      +        "Utilities Administration",
      +        "Utility System Construction",
      +        "Vehicle Repair and Maintenance",
      +        "Venture Capital and Private Equity Principals",
      +        "Veterinary Services",
      +        "Vocational Rehabilitation Services",
      +        "Warehousing and Storage",
      +        "Waste Collection",
      +        "Waste Treatment and Disposal",
      +        "Water Supply and Irrigation Systems",
      +        "Water, Waste, Steam, and Air Conditioning Services",
      +        "Wellness and Fitness Services",
      +        "Wholesale",
      +        "Wholesale Alcoholic Beverages",
      +        "Wholesale Apparel and Sewing Supplies",
      +        "Wholesale Appliances, Electrical, and Electronics",
      +        "Wholesale Building Materials",
      +        "Wholesale Chemical and Allied Products",
      +        "Wholesale Computer Equipment",
      +        "Wholesale Drugs and Sundries",
      +        "Wholesale Food and Beverage",
      +        "Wholesale Footwear",
      +        "Wholesale Furniture and Home Furnishings",
      +        "Wholesale Hardware, Plumbing, Heating Equipment",
      +        "Wholesale Import and Export",
      +        "Wholesale Luxury Goods and Jewelry",
      +        "Wholesale Machinery",
      +        "Wholesale Metals and Minerals",
      +        "Wholesale Motor Vehicles and Parts",
      +        "Wholesale Paper Products",
      +        "Wholesale Petroleum and Petroleum Products",
      +        "Wholesale Photography Equipment and Supplies",
      +        "Wholesale Raw Farm Products",
      +        "Wholesale Recyclable Materials",
      +        "Wind Electric Power Generation",
      +        "Wineries",
      +        "Wireless Services",
      +        "Women's Handbag Manufacturing",
      +        "Wood Product Manufacturing",
      +        "Writing and Editing",
      +        "Zoos and Botanical Gardens"
      +      ],
      +      "title": "TheirStackIndustry",
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / industry / description
      Previous value: -"LinkedIn-style industry names the company must match\n(e.g. [\"Retail\", \"Higher Education\"]). Values are validated\nagainst TheirStack's canonical catalog (431 industries) —\nwrong variants like \"Architecture & Planning\" raise ModelRetry\nwith close-match suggestions."New value: +"Industries the company must match, picked from this\nparameter's list of TheirStack industry names (e.g. [\"Retail\",\n\"Higher Education\"]). A name also matches its sub-industries:\n\"Manufacturing\" covers \"Motor Vehicle Manufacturing\". Some\nparents are broad (\"Consumer Services\" includes non-profits and\nreligious institutions), so name a parent only when all of it\nfits and list specific industries otherwise."
    • changedInput schema / properties / industry_excludes / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "enum": [
      +        "Abrasives and Nonmetallic Minerals Manufacturing",
      +        "Accessible Architecture and Design",
      +        "Accessible Hardware Manufacturing",
      +        "Accommodation Services",
      +        "Accounting",
      +        "Administration of Justice",
      +        "Administrative and Support Services",
      +        "Advertising Services",
      +        "Agricultural Chemical Manufacturing",
      +        "Agriculture, Construction, Mining Machinery Manufacturing",
      +        "Air, Water, and Waste Program Management",
      +        "Airlines and Aviation",
      +        "Alternative Dispute Resolution",
      +        "Alternative Fuel Vehicle Manufacturing",
      +        "Alternative Medicine",
      +        "Ambulance Services",
      +        "Amusement Parks and Arcades",
      +        "Animal Feed Manufacturing",
      +        "Animation and Post-production",
      +        "Apparel Manufacturing",
      +        "Appliances, Electrical, and Electronics Manufacturing",
      +        "Architectural and Structural Metal Manufacturing",
      +        "Architecture and Planning",
      +        "Armed Forces",
      +        "Artificial Rubber and Synthetic Fiber Manufacturing",
      +        "Artists and Writers",
      +        "Audio and Video Equipment Manufacturing",
      +        "Automation Machinery Manufacturing",
      +        "Aviation and Aerospace Component Manufacturing",
      +        "Baked Goods Manufacturing",
      +        "Banking",
      +        "Bars, Taverns, and Nightclubs",
      +        "Bed-and-Breakfasts, Hostels, Homestays",
      +        "Beverage Manufacturing",
      +        "Biomass Electric Power Generation",
      +        "Biotechnology Research",
      +        "Blockchain Services",
      +        "Blogs",
      +        "Boilers, Tanks, and Shipping Container Manufacturing",
      +        "Book Publishing",
      +        "Book and Periodical Publishing",
      +        "Breweries",
      +        "Broadcast Media Production and Distribution",
      +        "Building Construction",
      +        "Building Equipment Contractors",
      +        "Building Finishing Contractors",
      +        "Building Structure and Exterior Contractors",
      +        "Business Consulting and Services",
      +        "Business Content",
      +        "Business Intelligence Platforms",
      +        "Cable and Satellite Programming",
      +        "Capital Markets",
      +        "Caterers",
      +        "Chemical Manufacturing",
      +        "Chemical Raw Materials Manufacturing",
      +        "Child Day Care Services",
      +        "Chiropractors",
      +        "Circuses and Magic Shows",
      +        "Civic and Social Organizations",
      +        "Civil Engineering",
      +        "Claims Adjusting, Actuarial Services",
      +        "Clay and Refractory Products Manufacturing",
      +        "Climate Data and Analytics",
      +        "Climate Technology Product Manufacturing",
      +        "Coal Mining",
      +        "Collection Agencies",
      +        "Commercial and Industrial Equipment Rental",
      +        "Commercial and Industrial Machinery Maintenance",
      +        "Commercial and Service Industry Machinery Manufacturing",
      +        "Communications Equipment Manufacturing",
      +        "Community Development and Urban Planning",
      +        "Community Services",
      +        "Computer Games",
      +        "Computer Hardware Manufacturing",
      +        "Computer Networking Products",
      +        "Computer and Network Security",
      +        "Computers and Electronics Manufacturing",
      +        "Conservation Programs",
      +        "Construction",
      +        "Construction Hardware Manufacturing",
      +        "Consumer Goods Rental",
      +        "Consumer Services",
      +        "Correctional Institutions",
      +        "Cosmetology and Barber Schools",
      +        "Courts of Law",
      +        "Credit Intermediation",
      +        "Cutlery and Handtool Manufacturing",
      +        "Dairy Product Manufacturing",
      +        "Dance Companies",
      +        "Data Infrastructure and Analytics",
      +        "Data Security Software Products",
      +        "Defense and Space Manufacturing",
      +        "Dentists",
      +        "Design Services",
      +        "Desktop Computing Software Products",
      +        "Digital Accessibility Services",
      +        "Distilleries",
      +        "E-Learning Providers",
      +        "Economic Programs",
      +        "Education",
      +        "Education Administration Programs",
      +        "Electric Lighting Equipment Manufacturing",
      +        "Electric Power Generation",
      +        "Electric Power Transmission, Control, and Distribution",
      +        "Electrical Equipment Manufacturing",
      +        "Electronic and Precision Equipment Maintenance",
      +        "Embedded Software Products",
      +        "Emergency and Relief Services",
      +        "Engineering Services",
      +        "Engines and Power Transmission Equipment Manufacturing",
      +        "Entertainment Providers",
      +        "Environmental Quality Programs",
      +        "Environmental Services",
      +        "Equipment Rental Services",
      +        "Events Services",
      +        "Executive Offices",
      +        "Executive Search Services",
      +        "Fabricated Metal Products",
      +        "Facilities Services",
      +        "Family Planning Centers",
      +        "Farming",
      +        "Farming, Ranching, Forestry",
      +        "Fashion Accessories Manufacturing",
      +        "Financial Services",
      +        "Fine Arts Schools",
      +        "Fire Protection",
      +        "Fisheries",
      +        "Flight Training",
      +        "Food and Beverage Manufacturing",
      +        "Food and Beverage Retail",
      +        "Food and Beverage Services",
      +        "Footwear Manufacturing",
      +        "Footwear and Leather Goods Repair",
      +        "Forestry and Logging",
      +        "Fossil Fuel Electric Power Generation",
      +        "Freight and Package Transportation",
      +        "Fruit and Vegetable Preserves Manufacturing",
      +        "Fuel Cell Manufacturing",
      +        "Fundraising",
      +        "Funds and Trusts",
      +        "Furniture and Home Furnishings Manufacturing",
      +        "Gambling Facilities and Casinos",
      +        "Geothermal Electric Power Generation",
      +        "Glass Product Manufacturing",
      +        "Glass, Ceramics and Concrete Manufacturing",
      +        "Golf Courses and Country Clubs",
      +        "Government Administration",
      +        "Government Relations Services",
      +        "Graphic Design",
      +        "Ground Passenger Transportation",
      +        "HVAC and Refrigeration Equipment Manufacturing",
      +        "Health and Human Services",
      +        "Higher Education",
      +        "Highway, Street, and Bridge Construction",
      +        "Historical Sites",
      +        "Holding Companies",
      +        "Home Health Care Services",
      +        "Horticulture",
      +        "Hospitality",
      +        "Hospitals",
      +        "Hospitals and Health Care",
      +        "Hotels and Motels",
      +        "Household Appliance Manufacturing",
      +        "Household Services",
      +        "Household and Institutional Furniture Manufacturing",
      +        "Housing Programs",
      +        "Housing and Community Development",
      +        "Human Resources Services",
      +        "Hydroelectric Power Generation",
      +        "IT Services and IT Consulting",
      +        "IT System Custom Software Development",
      +        "IT System Data Services",
      +        "IT System Design Services",
      +        "IT System Installation and Disposal",
      +        "IT System Operations and Maintenance",
      +        "IT System Testing and Evaluation",
      +        "IT System Training and Support",
      +        "Individual and Family Services",
      +        "Industrial Machinery Manufacturing",
      +        "Industry Associations",
      +        "Information Services",
      +        "Insurance",
      +        "Insurance Agencies and Brokerages",
      +        "Insurance Carriers",
      +        "Insurance and Employee Benefit Funds",
      +        "Interior Design",
      +        "International Affairs",
      +        "International Trade and Development",
      +        "Internet Marketplace Platforms",
      +        "Internet News",
      +        "Internet Publishing",
      +        "Interurban and Rural Bus Services",
      +        "Investment Advice",
      +        "Investment Banking",
      +        "Investment Management",
      +        "Janitorial Services",
      +        "Landscaping Services",
      +        "Language Schools",
      +        "Laundry and Drycleaning Services",
      +        "Law Enforcement",
      +        "Law Practice",
      +        "Leasing Non-residential Real Estate",
      +        "Leasing Residential Real Estate",
      +        "Leather Product Manufacturing",
      +        "Legal Services",
      +        "Legislative Offices",
      +        "Libraries",
      +        "Lime and Gypsum Products Manufacturing",
      +        "Loan Brokers",
      +        "Machinery Manufacturing",
      +        "Magnetic and Optical Media Manufacturing",
      +        "Manufacturing",
      +        "Maritime Transportation",
      +        "Market Research",
      +        "Marketing Services",
      +        "Mattress and Blinds Manufacturing",
      +        "Measuring and Control Instrument Manufacturing",
      +        "Meat Products Manufacturing",
      +        "Media & Telecommunications",
      +        "Media Production",
      +        "Medical Equipment Manufacturing",
      +        "Medical Practices",
      +        "Medical and Diagnostic Laboratories",
      +        "Mental Health Care",
      +        "Metal Ore Mining",
      +        "Metal Treatments",
      +        "Metal Valve, Ball, and Roller Manufacturing",
      +        "Metalworking Machinery Manufacturing",
      +        "Military and International Affairs",
      +        "Mining",
      +        "Mobile Computing Software Products",
      +        "Mobile Food Services",
      +        "Mobile Gaming Apps",
      +        "Motor Vehicle Manufacturing",
      +        "Motor Vehicle Parts Manufacturing",
      +        "Movies and Sound Recording",
      +        "Movies, Videos and Sound",
      +        "Museums",
      +        "Museums, Historical Sites, and Zoos",
      +        "Musicians",
      +        "Nanotechnology Research",
      +        "Natural Gas Distribution",
      +        "Natural Gas Extraction",
      +        "Newspaper Publishing",
      +        "Non-profit Organizations",
      +        "Nonmetallic Mineral Mining",
      +        "Nonresidential Building Construction",
      +        "Nuclear Electric Power Generation",
      +        "Nursing Homes and Residential Care Facilities",
      +        "Office Administration",
      +        "Office Furniture and Fixtures Manufacturing",
      +        "Oil Extraction",
      +        "Oil and Coal Product Manufacturing",
      +        "Oil and Gas",
      +        "Oil, Gas, and Mining",
      +        "Online Audio and Video Media",
      +        "Online and Mail Order Retail",
      +        "Operations Consulting",
      +        "Optometrists",
      +        "Outpatient Care Centers",
      +        "Outsourcing and Offshoring Consulting",
      +        "Packaging and Containers Manufacturing",
      +        "Paint, Coating, and Adhesive Manufacturing",
      +        "Paper and Forest Product Manufacturing",
      +        "Pension Funds",
      +        "Performing Arts",
      +        "Performing Arts and Spectator Sports",
      +        "Periodical Publishing",
      +        "Personal Care Product Manufacturing",
      +        "Personal Care Services",
      +        "Personal and Laundry Services",
      +        "Pet Services",
      +        "Pharmaceutical Manufacturing",
      +        "Philanthropic Fundraising Services",
      +        "Photography",
      +        "Physical, Occupational and Speech Therapists",
      +        "Physicians",
      +        "Pipeline Transportation",
      +        "Plastics Manufacturing",
      +        "Plastics and Rubber Product Manufacturing",
      +        "Political Organizations",
      +        "Postal Services",
      +        "Primary Metal Manufacturing",
      +        "Primary and Secondary Education",
      +        "Printing Services",
      +        "Professional Organizations",
      +        "Professional Services",
      +        "Professional Training and Coaching",
      +        "Public Assistance Programs",
      +        "Public Health",
      +        "Public Policy Offices",
      +        "Public Relations and Communications Services",
      +        "Public Safety",
      +        "Racetracks",
      +        "Radio and Television Broadcasting",
      +        "Rail Transportation",
      +        "Railroad Equipment Manufacturing",
      +        "Ranching",
      +        "Ranching and Fisheries",
      +        "Real Estate",
      +        "Real Estate Agents and Brokers",
      +        "Real Estate and Equipment Rental Services",
      +        "Recreational Facilities",
      +        "Regenerative Design",
      +        "Religious Institutions",
      +        "Renewable Energy Equipment Manufacturing",
      +        "Renewable Energy Power Generation",
      +        "Renewable Energy Semiconductor Manufacturing",
      +        "Repair and Maintenance",
      +        "Research Services",
      +        "Residential Building Construction",
      +        "Restaurants",
      +        "Retail",
      +        "Retail Apparel and Fashion",
      +        "Retail Appliances, Electrical, and Electronic Equipment",
      +        "Retail Art Dealers",
      +        "Retail Art Supplies",
      +        "Retail Books and Printed News",
      +        "Retail Building Materials and Garden Equipment",
      +        "Retail Florists",
      +        "Retail Furniture and Home Furnishings",
      +        "Retail Gasoline",
      +        "Retail Groceries",
      +        "Retail Health and Personal Care Products",
      +        "Retail Luxury Goods and Jewelry",
      +        "Retail Motor Vehicles",
      +        "Retail Musical Instruments",
      +        "Retail Office Equipment",
      +        "Retail Office Supplies and Gifts",
      +        "Retail Pharmacies",
      +        "Retail Recyclable Materials & Used Merchandise",
      +        "Reupholstery and Furniture Repair",
      +        "Robot Manufacturing",
      +        "Robotics Engineering",
      +        "Rubber Products Manufacturing",
      +        "Satellite Telecommunications",
      +        "Savings Institutions",
      +        "School and Employee Bus Services",
      +        "Seafood Product Manufacturing",
      +        "Secretarial Schools",
      +        "Securities and Commodity Exchanges",
      +        "Security Guards and Patrol Services",
      +        "Security Systems Services",
      +        "Security and Investigations",
      +        "Semiconductor Manufacturing",
      +        "Services for Renewable Energy",
      +        "Services for the Elderly and Disabled",
      +        "Sheet Music Publishing",
      +        "Shipbuilding",
      +        "Shuttles and Special Needs Transportation Services",
      +        "Sightseeing Transportation",
      +        "Skiing Facilities",
      +        "Smart Meter Manufacturing",
      +        "Soap and Cleaning Product Manufacturing",
      +        "Social Networking Platforms",
      +        "Software Development",
      +        "Solar Electric Power Generation",
      +        "Sound Recording",
      +        "Space Research and Technology",
      +        "Specialty Trade Contractors",
      +        "Spectator Sports",
      +        "Sporting Goods Manufacturing",
      +        "Sports Teams and Clubs",
      +        "Sports and Recreation Instruction",
      +        "Spring and Wire Product Manufacturing",
      +        "Staffing and Recruiting",
      +        "Steam and Air-Conditioning Supply",
      +        "Strategic Management Services",
      +        "Subdivision of Land",
      +        "Sugar and Confectionery Product Manufacturing",
      +        "Surveying and Mapping Services",
      +        "Taxi and Limousine Services",
      +        "Technical and Vocational Training",
      +        "Technology, Information and Internet",
      +        "Technology, Information and Media",
      +        "Telecommunications",
      +        "Telecommunications Carriers",
      +        "Telephone Call Centers",
      +        "Temporary Help Services",
      +        "Textile Manufacturing",
      +        "Theater Companies",
      +        "Think Tanks",
      +        "Tobacco Manufacturing",
      +        "Translation and Localization",
      +        "Transportation Equipment Manufacturing",
      +        "Transportation Programs",
      +        "Transportation, Logistics, Supply Chain and Storage",
      +        "Travel Arrangements",
      +        "Truck Transportation",
      +        "Trusts and Estates",
      +        "Turned Products and Fastener Manufacturing",
      +        "Urban Transit Services",
      +        "Utilities",
      +        "Utilities Administration",
      +        "Utility System Construction",
      +        "Vehicle Repair and Maintenance",
      +        "Venture Capital and Private Equity Principals",
      +        "Veterinary Services",
      +        "Vocational Rehabilitation Services",
      +        "Warehousing and Storage",
      +        "Waste Collection",
      +        "Waste Treatment and Disposal",
      +        "Water Supply and Irrigation Systems",
      +        "Water, Waste, Steam, and Air Conditioning Services",
      +        "Wellness and Fitness Services",
      +        "Wholesale",
      +        "Wholesale Alcoholic Beverages",
      +        "Wholesale Apparel and Sewing Supplies",
      +        "Wholesale Appliances, Electrical, and Electronics",
      +        "Wholesale Building Materials",
      +        "Wholesale Chemical and Allied Products",
      +        "Wholesale Computer Equipment",
      +        "Wholesale Drugs and Sundries",
      +        "Wholesale Food and Beverage",
      +        "Wholesale Footwear",
      +        "Wholesale Furniture and Home Furnishings",
      +        "Wholesale Hardware, Plumbing, Heating Equipment",
      +        "Wholesale Import and Export",
      +        "Wholesale Luxury Goods and Jewelry",
      +        "Wholesale Machinery",
      +        "Wholesale Metals and Minerals",
      +        "Wholesale Motor Vehicles and Parts",
      +        "Wholesale Paper Products",
      +        "Wholesale Petroleum and Petroleum Products",
      +        "Wholesale Photography Equipment and Supplies",
      +        "Wholesale Raw Farm Products",
      +        "Wholesale Recyclable Materials",
      +        "Wind Electric Power Generation",
      +        "Wineries",
      +        "Wireless Services",
      +        "Women's Handbag Manufacturing",
      +        "Wood Product Manufacturing",
      +        "Writing and Editing",
      +        "Zoos and Botanical Gardens"
      +      ],
      +      "title": "TheirStackIndustry",
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / industry_excludes / description
      Previous value: -"Industry names to exclude. Same canonical-name\nvalidation as `industry`."New value: +"Industries to exclude, sub-industries included,\nfrom the same list as `industry`."
  4. Changed2 schema fields changed
    • addedInput schema / properties / agent_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Optional — a specific agent to save the companies into.\nOmit it to use the running agent, which is the usual case."
      +}
    • addedInput schema / properties / list_name
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Short kebab slug naming the Output-tab list bucket (e.g.\n'shopify-brands'). Absent, companies land in the 'default' list."
      +}
  5. First observed

TDQS

A4.7/5.0
Behavior5/5

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

Annotations only declare destructiveHint=false, so the description carries the behavioral burden and does so richly: it discloses that detection comes from job-posting text (absence != not using), that ecommerce results may include agencies/ISVs, that recruiting agencies are always excluded, the 1.5 credits/company cost model, that a failed search is free, the per-company criteria check cost in seconds, the save-to-Output-tab dedupe behavior, and graceful degradation via theirstack_available=False.

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-loads purpose and the sibling routing well, but the cost/count protocol (state count and cost every time, price the companies actually returned, page only when asked) is restated across several sentences and the embedded <returns> block duplicates what a returns schema would normally carry, making it longer than the task requires.

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 15-parameter mutation-adjacent search with no output schema and no annotation coverage of behavior, the description covers identification limits, cost accounting, criteria filtering, result landings, and failure mode — nothing an agent needs to invoke it correctly is missing.

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%, so the baseline is 3; the description still adds value by tying count/cost to the actual returned count, warning to prefer one page at the user's number over walking offset, and reiterating AND semantics and catalog-slug resolution for technologies.

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+resource ('Find companies whose technographic profile matches a target tech stack') and immediately distinguishes itself from its closest sibling by contrasting 'installed technology' discovery against theirstack_search's hiring-signal discovery. An agent can route between the two without opening either 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 'Use ONLY when the user explicitly wants to discover companies BY THEIR INSTALLED TECHNOLOGY', with concrete trigger examples ('find DTC brands using Shopify and Klaviyo'), plus an explicit exclusion routing to theirstack_search and the condition that selects it.

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