How do AI agents use TheirStack through Open Connector?

Your user connects TheirStack once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes TheirStack tools to your agent over MCP or a typed API, with credentials injected server-side on each call.

Is this a TheirStack MCP server?

Yes. Open Connector can serve TheirStack as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call TheirStack actions with credentials injected server-side.

Where do TheirStack credentials live?

In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.

TheirStack integration

TheirStack integration for AI agents.

TheirStack integration for AI agents with secure authentication and server-side credential injection. Open Connector runs the OAuth, seals the token in an encrypted vault, and serves TheirStack tools to your agent over MCP or a typed API — credentials injected server-side, every call audited, nothing leaving your infrastructure. Open source (AGPL-3.0) and self-hostable.

View source on GitHub All integrations →

What your agents can do

Real TheirStack actions, managed and audited.

Your user connects TheirStack once; your agent can then use the TheirStack API to search jobs, companies, technographics, buying intents, catalogs, company lists, saved searches, webhooks, and billing credit balance — scoped to the OAuth permissions you grant and the tool allowlist you configure. Every action is least-privilege and written to a tamper-evident audit trail.

1
Your user grants TheirStack access once (OAuth) — the token lands in the vault.
2
Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.
3
Every routed call appends a hash-chained audit record — nothing leaves your infra.

Tools & triggers

Supported TheirStack tools.

52 tools are generated from the published TheirStack catalog. Descriptions are plain text; each action remains subject to its configured authentication and tool allowlist.

Showing 52 tools. All published catalog entries are included in this page's server-rendered HTML.

Buying Intents: This endpoint lists the buying intent topics detected for a company. For each topic, it returns the confidence level (`low`, `medium`, `high`), the number of jobs that mention the topic, and the first and last dates it was mentioned. You must specify `company_domain`, `company_name`, `company_linkedin_url`. It consumes **3 API credits** per company lookup, regardless of the number of buying intent topics returned. It doesn't consume credits if there is no response.; Companies
Delete Company List: Delete Company List; Company Lists
Generate App Url: Build a deep link into the TheirStack app for a given resource and return it as `{"url": ...}`. Pick the resource with the `type` field: `company_list` (view a list), `job_search` / `company_search` (open a search from filters — same filter shape as `search_jobs_v1` / `search_companies_v1`), `saved_search` (open a saved search), or `webhook` (view a webhook). Search links (`job_search` / `company_search`) are workspace-independent — the encoded query opens against whoever's session loads it, so the link is portable when shared. The other types point at a workspace-specific resource and include the workspace, which is taken from the authenticated caller, so it is never passed in.; App URLsApp URLs
Get Credit Balance: Retrieve your team's current credit balance including remaining credits available for API calls, searches, and data exports across all endpoints.; Billing
Get Companies Per Company Country Code: Retrieve all ISO country codes with the number of companies headquartered in each country. Use this endpoint for geographic distribution analysis. Calls to this endpoint are free and do not consume any API credits.; Catalog
Get Industries: This endpoint lets you list all the industries and their codes, see how many jobs and companies we have per industry and search for an industry. Calls to this endpoint don't cost you credits. Our industries catalogue comes from [LinkedIn Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2); Catalog
Get Jobs And Companies Per Job Country Code: This endpoint will return all the country codes and the number of jobs whose location's country code is the given one, and the number of companies with jobs in that country. Calls to this endpoint don't cost you credits.; Catalog
Get Technologies And Buying Intents: List all keywords tracked by TheirStack, including both technologies and buying intent topics. Search for any keyword and filter by one or more categories. Calls to this endpoint don't cost you credits. - To get technologies only: filter with `keyword_type=technology` - To get only buying intent topics: filter with `keyword_type_not=technology` - By default this endpoint returns 25 keywords. To get all keywords, set `limit=100000`. Response always includes `data` (array of keywords) and `metadata` (total_results, page, limit).; Catalog
Get Geographic Locations: Search for geographic locations by name or ID to retrieve standardized location data including city, region, and country. Use location IDs with job_location_or and job_location_not filters for precise geographic targeting in job searches.; Catalog
Get List: Get List; Company Lists
Export Companies From List: Export companies from a saved list to a downloadable CSV or XLSX file. The export includes company details such as domain, industry, size, location, funding, and revenue data for offline analysis.; Company Lists
Get Companies From List: Get Companies From List; Company Lists
List All Lists: Retrieve all company lists for the current team including list name, company count, and creation date. Use company lists to organize and segment companies for targeted outreach and analysis.; Company Lists
List Datasets: Retrieve all datasets available for your team including jobs, companies, and technographics. Datasets are updated daily in Parquet format. Use this endpoint to get the latest download URLs for bulk data access.; Datasets
Get Email Preferences: Get Email Preferences; Email Preferences
Get Request Count: Retrieve the daily count of API requests made by your team within a specified date range. Use this endpoint to monitor API usage patterns, identify peak activity periods, and plan capacity.; Requests
List Requests: List your team's individual API and app requests in a time range. Each request reports how many credits it consumed (api_credits, ui_credits), its response time (duration, in seconds), HTTP status code, endpoint type and the number of records returned. Use it to inspect per-request consumption and latency. Defaults to the last 5 days when no dates are given.; Requests
Get Saved Search: Get Saved Search; Saved Searches
List All Saved Searches: Retrieve all active saved searches for the current user including search filters, type, and creation date. Archived saved searches are excluded. Filter by user IDs or search type and sort by name, created, or updated date.; Saved Searches
Get Credits Consumption: Retrieve daily credit consumption data for your team showing the number of API records returned per day. Use this endpoint to monitor usage trends, track spending, and optimize your API integration.; Credit Consumption
Get Webhook By Id: Retrieve the full details of a specific webhook by its ID including configuration, status, target URL, event type, linked saved search, and creation timestamp. Use this to inspect or debug a webhook setup.; Webhooks
List Webhook Event Types: Returns supported webhook event types with their metadata. Pass `search_type=jobs` or `search_type=companies` to get only the events relevant to that search type.; Webhooks
Get Aggregated Webhook Event Count: Retrieve webhook event counts aggregated by day within a date range, with options to group by delivery status or webhook ID. Use this endpoint to build time-series charts for monitoring webhook performance and reliability.; Webhooks
Get Webhook Event Count: Get the total count of events triggered for a specific webhook. Use this endpoint to quickly check webhook activity volume without fetching the full event list, useful for monitoring dashboards and usage tracking.; Webhooks
List Webhook Events: Retrieve a paginated list of all events triggered for a specific webhook including delivery status, payload, and timestamps. Filter by event status to find failed deliveries that may need to be retried.; Webhooks
List All Webhooks: Retrieve all active webhooks configured for your team including their status, target URL, event type, and linked saved search. Archived webhooks are excluded from the response. Use this to monitor your webhook integrations.; Webhooks
Get Keyword Categories: Returns a list of main keyword categories (technologies and buying intents) with the number of keywords and companies in each. Optionally filters to return a specific category if category_slug is provided.; Catalog
Get Keyword Subcategories: Returns a list of keyword subcategories with their keywords. Behavior: returns all subcategories if no parameters are provided; returns all subcategories for a specific parent category if only category_slug is provided; returns a specific subcategory if both category_slug and subcategory_slug are provided.; Catalog
Rename Company List: Rename Company List; Company Lists
Archive Saved Search: Archive a saved search by its ID to remove it from the active list. Archived searches are hidden from the default listing but can still be referenced. Associated webhooks will stop triggering for archived searches.; Saved Searches
Update Saved Search: Update Saved Search; Saved Searches
Archive Webhook: Archive a webhook by its ID to permanently stop event delivery and remove it from the active webhook list. Archived webhooks and their event history are retained for reference but will no longer trigger notifications.; Webhooks
Update Webhook: Update Webhook; Webhooks
Enable/Disable A Webhook: By disabling a webhook, it will stop listening to events. When you enable a webhook, it will process all the events that have not been processed yet since you disabled it.; Webhooks
Add Companies To Multiple Lists: Add Companies To Multiple Lists; Company Lists
Add Companies To List: Add Companies To List; Company Lists
Duplicate List: Duplicate List; Company Lists
Remove Companies From List: Remove Companies From List; Company Lists
Create Company List: Create Company List; Company Lists
Generate Dataset Credentials: Generate temporary S3 credentials to directly access and download dataset files from cloud storage. Credentials are valid for 7 days by default and provide read-only access to your team's available datasets.; Datasets
Create Saved Search: Create Saved Search; Saved Searches
Retry Webhook Events: Retry delivery of failed webhook events by providing their event IDs. Use this endpoint to recover from transient failures such as network timeouts or temporary server errors on your receiving endpoint.; Webhooks
Test Webhook Url: Send a test event to verify connectivity and payload handling. Either provide a webhook_id to test an existing webhook (with optional url/secret overrides), or provide url and event_type directly to test before creating a webhook.; Webhooks
Create New Webhook: Create a new webhook that listens for events from a saved search and sends real-time HTTP POST notifications to your specified URL. Configure event types, filters, and delivery settings for automated data pipelines.; Webhooks
Update Email Preferences: Update Email Preferences; Email Preferences
Company Search: Search and filter companies and accounts by firmographics (industry, country, employee count, revenue), funding, technology and tech stack (technographics), and hiring signals (which roles and technologies they are actively hiring for). Built for ABM, account and lead prospecting, lookalike-account discovery, competitive displacement, and buying-intent targeting. Returns the matching companies along with the jobs and technology objects that matched the filters you passed. It consumes **3 API credits** for each company returned in the response. Useful resources: [Preview data mode](https://theirstack.com/en/docs/api/preview-data-mode), [Free count mode](https://theirstack.com/en/docs/api/free-count) The response includes both company data and any matching jobs or technologies based on your filters.; Companies
Job Search: Search and filter job postings (job ads, vacancies, hiring data) from thousands of company career sites and job boards. Filter by job title, keywords in the job description, company (name, domain or LinkedIn URL), location and country, technology and tech stack, salary, seniority, remote/hybrid, employment type, and posting date. Used for sales prospecting and lead generation, recruiting, and hiring-trend and market research. It consumes **1 API credit** for each job returned in the response. You must specify at least one of the following filters, or otherwise your request will fail: `posted_at_max_age_days`, `posted_at_gte`, `posted_at_lte`, `company_domain_or`, `company_linkedin_url_or`, `company_name_or`. This is for performance reasons. To retrieve jobs from a specific company or a list of companies, you can apply any of the following filters: `company_domain_or`, `company_linkedin_url_or`, `company_name_or`, `company_name_case_insensitive_or`. When using multiple company identifier filters, the endpoint will return jobs from companies that match any of the specified identifiers. Therefore, it is advisable to create a separate request for each company if you intend to use more than one identifier. This endpoint is used by job seekers and sales/marketing teams to search for jobs filtered by country, job title, technologies, job description, company name, company domain, or date range—see the payload examples below for specific use cases. Useful resources: [Avoiding getting the same job twice](https://theirstack.com/en/docs/api/avoid-getting-same-jobs-twice), [Fetching jobs periodically](https://theirstack.com/en/docs/guides/fetch-jobs-periodically), [Preview data mode](https://theirstack.com/en/docs/api/preview-data-mode), [Free count mode](https://theirstack.com/en/docs/api/free-count); Jobs
Technographics: This endpoint lists the technologies used by a company. For each technology, it returns the confidence level (`low`, `medium`, `high`), the number of jobs that mention the technology, and the first and last dates it was mentioned. You must specify `company_domain`, `company_name`, `company_linkedin_url`. It consumes **3 API credits** per company lookup, regardless of the number of technologies returned. It doesn't consume credits if there is no response.; Companies
One-Click Unsubscribe (Rfc 8058): One-Click Unsubscribe (Rfc 8058); Email Preferences
Unsubscribe From Email: Unsubscribe From Email; Email Preferences
One-Click Unsubscribe From A Saved Search Alert (Rfc 8058): One-Click Unsubscribe From A Saved Search Alert (Rfc 8058); Saved Searches
Unsubscribe From A Saved Search Alert: Unsubscribe From A Saved Search Alert; Saved Searches

FAQ

TheirStack integration, answered

How do AI agents use TheirStack through Open Connector?: Your user connects TheirStack once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes TheirStack tools to your agent over MCP or a typed API, with credentials injected server-side on each call.
Is this a TheirStack MCP server?: Yes. Open Connector can serve TheirStack as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call TheirStack actions with credentials injected server-side.
Where do TheirStack credentials live?: In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.

Give your agents TheirStack — keep the keys.

Open source, self-hostable, with TheirStack credentials that never leave your infrastructure. Run it from source today.

View source on GitHub How the MCP gateway works →