Tool reference

Your assistant discovers and calls SeekOut MCP tools as needed. You normally describe the recruiting outcome you want instead of naming a tool. Use this reference to understand what each tool can access or change. For task-oriented guidance, see Recruiting workflows and Work with candidates.

Tool availability depends on your SeekOut permissions, enabled talent data sources, connected integrations, and available credits.

How search state works

SeekOut MCP maintains search state during an MCP session. The state can include a talent data source, geographic index, query, and filters. Tools that update this state let your assistant build a search incrementally before running it. A typical search uses the tools in this order:

Select a talent data source and geographic index.
Add a query and filters.
Run the search or inspect the result count.
Retrieve profiles or a shareable search link.
Clear the search state before starting an unrelated search.

Badges call out non-default behavior shared by every tool in a subsection. Requirements specific to one tool are included in its description.

Search tools

Set the search context

You can select only talent data sources and geographic indices available to your account.

Tool	Description
`set_vertical`	Select the talent data source used by subsequent search calls.
`set_index`	Select the geographic index used by subsequent search calls.

Update a search

Tool	Description
`set_query`	Set or replace the Boolean search expression.
`add_filter`	Add a supported filter field and value.
`remove_filter`	Remove a filter value or clear a filter field.

Inspect a search

Tool	Description
`get_state`	Return the current data source, index, query, filters, and optionally the runtime query payload.
`browse_power_filters`	List available filters and values for an accessible talent data source.

Run a search

Tool	Description
`search_people`	Search for people using the current query and filters.
`count_results`	Count candidates matching the current query and filters.
`pipeline_overview`	Summarize a connected ATS pipeline by status, recruiter, and stage.
`unified_search`	Search across multiple talent data sources available to your account.

Find entities, profiles, and links

Tool	Description
`search_entities`	Find an entity by name.
`search_entities_batch`	Find multiple entities in one request.
`get_profile`	Retrieve full candidate profiles by profile key.
`get_search_links`	Return a shareable SeekOut link for the current search.

Reset the search

Tool	Description
`clear_search`	Clear the accumulated state before starting another search.

Discovery and market analysis

Tool	Description
`discover_companies`	Find companies matching industry or market criteria and map them to SeekOut entities.
`verify_search`	Check the quality of the current search before returning candidate results.
`market_analysis`	Analyze a talent market across requested dimensions.
`compare_markets`	Compare a talent pool across as many as six cities.

Workspace tools

All workspace tools require Recruit workspace access. Changes made through MCP remain available in Recruit.

View workspaces

Tool	Description
`list_workspaces`	List accessible candidate workspaces.

Change workspaces

Tool	Description
`create_workspace`	Create a candidate workspace.
`add_to_workspace`	Add selected candidate profiles to a workspace.
`update_workspace_search`	Replace a workspace’s base search with the current search.
`add_search_to_workspace`	Add the current search to a workspace as a saved search.

Contact and export tools

See Work with candidates for user-facing guidance and approval considerations.

Retrieve contact details

These tools require candidate profiles.

Tool	Description
`get_emails`	Retrieve verified candidate email addresses.
`get_phones`	Retrieve candidate phone numbers.

Check contact requests

Tool	Description
`check_contacts`	Check the status of a pending contact-retrieval request.

Export profiles

This tool requires candidate profiles.

Tool	Description
`export_profiles`	Export candidate profiles to Excel or Google Sheets.

View ATS connections

Tool	Description
`list_ats_connections`	List the ATS integrations available to your organization.

Send candidates to your ATS

This tool requires a connected ATS and access to the destination.

Tool	Description
`export_to_ats`	Send selected candidates to a connected ATS.

Check credits

Tool	Description
`check_credits`	Return the remaining contact and export credits.

Organization data tools

Availability follows your organization’s connected data sources and your SeekOut permissions.

Tool	Description
`describe_org_schema`	List the fields and values that can be searched in your organization’s data.
`resolve_skills_for_org`	Match free-text skills to your organization’s skill vocabulary.
`analyze_bench_depth`	Evaluate successor or replacement candidates for a critical role.

Workflow resources

SeekOut MCP also exposes workflow skills as MCP resources. Compatible clients can list the available resources and load the relevant workflow content when needed.

Resource operation	Description
`list_resources`	List available workflow resources and their URIs.
`read_resource`	Load a workflow resource by URI.

See Recruiting workflows for user-facing examples.

Getting started

Connect your assistant

Use SeekOut MCP

Security and access

Reference and help

How search state works

Search tools

Set the search context

Update a search

Inspect a search

Run a search

Find entities, profiles, and links

Reset the search

Discovery and market analysis

Workspace tools

View workspaces

Change workspaces

Contact and export tools

Retrieve contact details

Check contact requests

Export profiles

View ATS connections

Send candidates to your ATS

Check credits

Organization data tools

Workflow resources

​How search state works

​Search tools

​Set the search context

​Update a search

​Inspect a search

​Run a search

​Find entities, profiles, and links

​Reset the search

​Discovery and market analysis

​Workspace tools

​View workspaces

​Change workspaces

​Contact and export tools

​Retrieve contact details

​Check contact requests

​Export profiles

​View ATS connections

​Send candidates to your ATS

​Check credits

​Organization data tools

​Workflow resources

How search state works

Search tools

Set the search context

Update a search

Inspect a search

Run a search

Find entities, profiles, and links

Reset the search

Discovery and market analysis

Workspace tools

View workspaces

Change workspaces

Contact and export tools

Retrieve contact details

Check contact requests

Export profiles

View ATS connections

Send candidates to your ATS

Check credits

Organization data tools

Workflow resources