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.

​

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:

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

Each tool row includes one behavior category matching the SeekOut MCP server reference. Behavior legend

• read-only reads SeekOut data without modifying anything.
• session uses or changes in-memory search session state without an external write.
• stateless performs an independent lookup without using search session state.
• session reset clears accumulated search session state.
• write creates, changes, or sends persistent data outside the search session.
• credits consumes SeekOut Recruit credits.

​

Search tools

​

Set the search context

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

​

set_vertical

Select the talent data source used by subsequent search calls. session

​

set_index

Select the geographic index used by subsequent search calls. session

​

Update a search

​

set_query

Set or replace the Boolean search expression. session

​

add_filter

Add a supported filter field and value. session

​

remove_filter

Remove a filter value or clear a filter field. session

​

Inspect a search

​

get_state

Return the current data source, index, query, filters, and optionally the runtime query payload. session

​

browse_power_filters

List available filters and values for an accessible talent data source. stateless

​

Run a search

​

search_people

Search for people using the current query and filters. read-only

​

count_results

Count candidates matching the current query and filters. read-only

​

pipeline_overview

Summarize a connected ATS pipeline by status, recruiter, and stage. read-only

​

unified_search

Search across multiple talent data sources available to your account. read-only

​

Find entities, profiles, and links

​

search_entities

Find an entity by name. stateless

​

search_entities_batch

Find multiple entities in one request. stateless

​

get_profile

Retrieve full candidate profiles by profile key. read-only

​

get_search_links

Return a shareable SeekOut link for the current search. read-only

​

Reset the search

​

clear_search

Clear the accumulated state before starting another search. session reset

​

Discovery and market analysis

​

discover_companies

Find companies matching industry or market criteria and map them to SeekOut entities. read-only

​

verify_search

Check the quality of the current search before returning candidate results. read-only

​

market_analysis

Analyze a talent market across requested dimensions. read-only

​

compare_markets

Compare a talent pool across as many as six cities. read-only

​

talent_dashboard

Assemble a talent-market report from several verified searches in one call, with result counts and facet breakdowns. Markets that cannot be resolved are reported as unavailable rather than estimated. read-only

​

Workspace tools

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

​

View workspaces

​

list_workspaces

List accessible candidate workspaces. read-only

​

Change workspaces

​

create_workspace

Create a candidate workspace. write

​

add_to_workspace

Add selected candidate profiles to a workspace. write

​

update_workspace_search

Replace a workspace’s base search with the current search. write

​

add_search_to_workspace

Add the current search to a workspace as a saved search. write

​

Contact and export tools

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

​

Retrieve contact details

These tools require candidate profiles.

​

get_emails

Retrieve verified candidate email addresses. credits

​

get_phones

Retrieve candidate phone numbers. credits

​

Check contact requests

​

check_contacts

Check the status of a pending contact-retrieval request. read-only

​

Export profiles

This tool requires candidate profiles.

​

export_profiles

Export candidate profiles to Excel or Google Sheets. credits

​

View ATS connections

​

list_ats_connections

List the ATS integrations available to your organization. read-only

​

Send candidates to your ATS

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

​

export_to_ats

Send selected candidates to a connected ATS. write

​

Check credits

​

check_credits

Return the remaining contact and export credits. read-only

​

Organization data tools

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

​

describe_org_schema

List the fields and values that can be searched in your organization’s data. read-only

​

resolve_skills_for_org

Match free-text skills to your organization’s skill vocabulary. read-only

​

analyze_bench_depth

Evaluate successor or replacement candidates for a critical role. read-only

​

Feedback and support tools

​

report_bug

Send a bug report, product feedback, or feature request to SeekOut with a session snapshot to help reproduce the issue. write

​

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. See Recruiting workflows for user-facing examples.

​

list_resources

List available workflow resources and their URIs. stateless

​

read_resource

Load a workflow resource by URI. stateless

​

Interactive result actions

Some assistants render SeekOut results as an interactive card instead of plain text. When you act on that card — opening a profile, adding a filter, saving a candidate to a workspace — the assistant runs a single tool on your behalf. Only an allowlisted set of actions can run this way: viewing profiles and search state, refining the current search, listing workspaces, saving candidates to a workspace, and retrieving or exporting contact details. Actions that delete or overwrite data are not available from an interactive result, and every action applies your existing SeekOut permissions and credit limits.

​

execute_app_action

Run an action you triggered from an interactive SeekOut result, such as opening a candidate profile or saving candidates to a workspace. write