Sliq

Theirstack Search

theirstack_search

Use to find companies hiring for a role / tech stack / headcount-band. The return shape includes company.domain directly — feed that to record_search_results as identifier without an Apollo round-trip. For installed-base discovery — companies that already use a technology, rather than hire around it — use find_companies_by_tech_stack instead.

Costs 0.5 Sliq credits per job posting 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 postings — 12.5 credits; say if you want more, max 100." Price the postings actually returned, which count gives: fewer than limit costs less.

On a scheduled scan there is no reply to state it in: pass the number the user chose at setup, carried in the scan spec as theirstack_limit.

Provide at least one of job_title_keywords, job_title_exact, description_keywords, or industry — without some kind of scope filter, searches return too many results. Empty results are normal; broaden filters and call again.

Every call names its industry scope: industry, or the company_keywords and company_description_keywords pair for a vertical the industry catalog doesn't name; a call with none of the three raises ModelRetry. When the target companies aren't defined by industry at all, pass industry=[].

Each returned job's job_description is truncated to 250 chars (with an ellipsis suffix). The full posting body is often 1-3KB; the agent only needs a short excerpt for the signals[i].summary field, and the full body would bloat the LLM context across multiple rounds.

Each company the postings belong to is then checked against criteria, one company at a time, reading its name, firmographics and postings, and only the postings at matching companies come back in jobs; 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 workspace Output tab as an agent_search_results company row (deduped by domain, entity_type='company') with its verdict, carrying its hiring postings in data.signals and its firmographics; the rejected ones are hidden from the list's default view. Re-running updates rows in place. Pass list_name to name their list; absent, they land in the 'default' list. A dict with jobs, the postings at matching companies; rejected, the companies the check turned down, as {name, reason}; count, every posting returned, rejected companies' included, which is the number billed; and created_identifiers, the domains of the matching companies this call newly added to the list, not ones already on it. Each job carries job_title, job_description (truncated to 250 chars), url, date_posted, a company dict (name, domain, industry, employee_count, annual_revenue_usd, linkedin_url, country, city), and its company's verdict ('qualified', or 'unclear' when the company's details say too little to judge) and verdict_reason, with a null verdict when the check couldn't run. On upstream failure (timeout / 5xx / auth / quota), it returns jobs=[], count=0, and theirstack_available=False so the agent can degrade to other sources.

Input Schema

TableJSON Schema

Name	Required	Description
`limit`	No	Job postings this ONE call returns, 1-100 (values outside are clamped), default 25. On a scan, the spec's `theirstack_limit` is the whole run's budget across every hiring signal — divide it by the number of signals to get this call's number, don't pass it whole to each. There is no pagination on this endpoint, so this is the whole ceiling for a given filter set.
`persist`	No	Default True — in an agent, the companies are saved as company rows automatically (see above). Pass False only for a read-only lookup the user doesn't want on a list.
`agent_id`	No	Optional — a specific agent to save the companies into. Omit it to use the running agent, which is the usual case. Only a throwaway lookup outside any agent returns postings without saving.
`criteria`	Yes	What makes a company a match for this search, in plain words: the kind of company and the hiring that qualifies it (e.g. "B2B software companies hiring sales development reps"). Each company the postings belong to 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.
`industry`	No	Industries the company must match, picked from this parameter's list of TheirStack industry names (e.g. ["Real Estate", "Architecture and Planning"]). 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_name`	No	Short kebab slug naming the Output-tab list bucket (e.g. 'hiring-sdrs'). Absent, companies land in the 'default' list.
`company_city`	No	City/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 `company_country_codes` to keep matches scoped.
`on_behalf_of`	No	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.
`lookback_days`	No	Days of job-posting history to scan (default 14). A news scan passes the window from its trigger prompt.
`job_title_exact`	No	Exact-match titles (TheirStack-indexed; use for short terms like "Snowflake" or "Chief" where regex would over-match).
`min_revenue_usd`	No	Minimum company annual revenue in USD (e.g. 10_000_000 for $10M+).
`company_keywords`	No	Concepts the company hires around, drawn from TheirStack's keyword catalog (e.g. ["Computer Vision", "Large Language Model (LLM)"]; slugs like "computer-vision" also work). Matches a company when any of its job postings mention the keyword, so it describes what the company does. Use it for verticals the industry taxonomy has no entry for — artificial intelligence, machine learning, computer vision. Values are resolved against the catalog; an unknown one raises ModelRetry with close matches rather than silently matching nothing.
`industry_excludes`	No	Industries to exclude, sub-industries included, from the same list as `industry`.
`job_country_codes`	No	ISO alpha-2 — where the job is posted (e.g. ["US"]).
`job_title_excludes`	No	Regex partial-match phrases to filter out of titles.
`job_title_keywords`	No	Regex partial-match phrases on title (case-insensitive).
`max_employee_count`	No	Maximum company headcount.
`min_employee_count`	No	Minimum company headcount.
`description_excludes`	No	Regex partial-match phrases to filter out of job bodies (e.g. ["intern", "contractor", "1099"]).
`description_keywords`	No	Regex partial-match phrases on the job body.
`company_country_codes`	No	ISO alpha-2 — where the company is HQ'd.
`company_description_keywords`	No	Regex partial-match phrases on the company's own description — what the company says about itself, as opposed to `description_keywords`, which matches the job posting body. Already case-insensitive, so pass the phrase as-is. Pair it with `company_keywords` and an employee band: on its own each of the two admits staffing agencies and job boards, which both self-describe in the vertical's language and post jobs mentioning every technology.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 19, 2026

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."
+}

Changed2 schema fields changedOct 7, 2026

addedInput schema / properties / criteria

Added value: +{
+  "description": "What makes a company a match for this search, in plain words:\nthe kind of company and the hiring that qualifies it (e.g. \"B2B\nsoftware companies hiring sales development reps\"). Each company the\npostings belong to is checked against it, and the check reads\nnothing else of your instructions, so make it no narrower than what\nthis call searches for. A role that is part of the signal belongs\nhere; who you'll contact at a matching company doesn't, since the\ncheck reads that as a rule about which companies match.",
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / required
```
Added value: +[
+  "criteria"
+]
```

Changed4 schema fields changedOct 1, 2026

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. [\"Real Estate\", \"Architecture and Planning\"]). Values are\nvalidated against 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. [\"Real\nEstate\", \"Architecture and Planning\"]). A name also matches its\nsub-industries: \"Manufacturing\" covers \"Motor Vehicle\nManufacturing\". Some parents are broad (\"Consumer Services\"\nincludes non-profits and religious institutions), so name a\nparent only when all of it fits and list specific industries\notherwise."

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`."

Changed1 schema field changedSep 30, 2026

changedInput schema / properties / persist / description

Previous value: -"Default True — in an agent, the companies are saved as company\nrows automatically (see above). Pass False to return the postings\nwithout saving, for a read-only query or a flow that records a\nvalidated/filtered subset itself."New value: +"Default True — in an agent, the companies are saved as company\nrows automatically (see above). Pass False only for a read-only\nlookup the user doesn't want on a list."

Changed3 schema fields changedSep 23, 2026

addedInput schema / properties / agent_id

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Optional — a specific agent to save the companies into. Omit\nit to use the running agent, which is the usual case. Only a\nthrowaway lookup outside any agent returns postings without saving."
+}

changedInput schema / properties / persist / description

Previous value: -"Default True — in a task, the companies are saved as company\nrows automatically (see above). Pass False to return the postings\nwithout saving, for a read-only query or a flow that records a\nvalidated/filtered subset itself."New value: +"Default True — in an agent, the companies are saved as company\nrows automatically (see above). Pass False to return the postings\nwithout saving, for a read-only query or a flow that records a\nvalidated/filtered subset itself."

removedInput schema / properties / task_id

Removed value: -{
-  "anyOf": [
-    {
-      "type": "integer"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Optional — a specific task to save the companies into. Omit\nit to use the running task, which is the usual case. Only a\nthrowaway lookup outside any task returns postings without saving."
-}

Changed3 schema fields changedSep 22, 2026

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'hiring-sdrs'). Absent, companies land in the 'default' list."
+}

addedInput schema / properties / persist

Added value: +{
+  "default": true,
+  "description": "Default True — in a task, the companies are saved as company\nrows automatically (see above). Pass False to return the postings\nwithout saving, for a read-only query or a flow that records a\nvalidated/filtered subset itself.",
+  "type": "boolean"
+}

addedInput schema / properties / task_id

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Optional — a specific task to save the companies into. Omit\nit to use the running task, which is the usual case. Only a\nthrowaway lookup outside any task returns postings without saving."
+}

First observedSep 15, 2026

TDQS

A4.8/5.0

Behavior5/5

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

Annotations (readOnlyHint=false, destructiveHint=false) only say it mutates nothing dangerous; the description goes far beyond by disclosing credit cost (0.5/posting, free on failure), 250-char truncation of job_description with rationale, the per-company criteria check adding seconds per ten companies, auto-persistence to the Output tab, in-place updates on re-run, list bucketing, and the `theirstack_available=False` degradation path.

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

Conciseness4/5

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

Front-loaded with purpose and the alternative-tool routing, then structured into summary/returns. It is long and the cost/compliance instructions are verbose, but for a 22-param, credit-charging, persisting tool most sentences earn their place. Some tightening is possible.

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?

No output schema, yet a full <returns> section documents jobs, rejected, count (billed number), created_identifiers, per-job fields, verdict semantics, and the upstream-failure shape. Combined with param, cost, and persistence coverage, nothing an agent needs to invoke 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% (baseline 3), but the description adds real meaning: `count` drives billing and can be less than `limit`, `limit` is a whole-run budget on scans to be divided across signals, and it clarifies when to reach for `company_keywords` vs `industry`. These are semantic distinctions not obvious from the schema alone.

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?

States a specific verb (Search), resource (recent job postings via TheirStack), and purpose (company discovery by hiring signal). It explicitly distinguishes itself from the sibling `find_companies_by_tech_stack` by naming it and contrasting installed-base vs hiring-signal discovery.

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?

Gives explicit when-to-use (role/tech stack/headcount-band hiring), when-to-use-the-alternative (installed-base discovery → find_companies_by_tech_stack), and hard requirements (at least one of job_title_keywords/job_title_exact/description_keywords/industry; industry scope or ModelRetry). Also explains that empty results are normal and to broaden filters.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Sliq tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?