> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seekout.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tool reference

> Review the tools SeekOut MCP can use, including their requirements, session behavior, write effects, and credit usage.

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](/mcp/capabilities/workflows) and [Work with candidates](/mcp/capabilities/candidate-actions).

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

## 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.

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

<Badge stroke color="blue" size="sm">
  {"Updates search state"}
</Badge>

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

<Badge stroke color="blue" size="sm">
  {"Updates search state"}
</Badge>

| 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

<Badge stroke color="orange" size="sm">
  {"Clears search state"}
</Badge>

| 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

<Badge stroke color="orange" size="sm">
  {"Writes to Recruit"}
</Badge>

| 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](/mcp/capabilities/candidate-actions) for user-facing guidance and approval considerations.

### Retrieve contact details

<Badge stroke color="purple" size="sm">
  {"Uses contact credits"}
</Badge>

<Badge stroke color="blue" size="sm">
  {"Syncs to Recruit"}
</Badge>

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

<Badge stroke color="purple" size="sm">
  {"Uses export credits"}
</Badge>

<Badge stroke color="blue" size="sm">
  {"Creates an export"}
</Badge>

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

<Badge stroke color="orange" size="sm">
  {"Writes to ATS"}
</Badge>

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

<Badge stroke color="yellow" size="sm">
  {"Requires connected data"}
</Badge>

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

<Badge stroke color="yellow" size="sm">
  {"Client-dependent"}
</Badge>

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](/mcp/capabilities/workflows) for user-facing examples.