Reference
SeekOut MCP Operations Reference
Complete list of tools the SeekOut MCP Search Server exposes to AI assistants, organized by domain with color-coded annotations.
The SeekOut MCP Search Server exposes 35 operation tools organized into five domains, plus 2 resource tools for loading workflow skills. Search tools accumulate session state (filters, query, index, vertical) across calls so you build up a search incrementally.
Annotation Legend
Each tool is tagged with a badge that signals its runtime behavior:
| Badge | Meaning |
|---|
| read-only | Reads SeekOut data without modifying anything. |
| session | Mutates in-memory search session state. No external write. |
| stateless | Independent lookup that doesn't touch session state. |
| session reset | Clears accumulated session state. |
| write | Modifies data in SeekOut Recruit. |
| credits | Consumes SeekOut Recruit credits. |
Query building, filtering, search execution, entity resolution, and session management.
Query & filter accumulation
| Tool | Description | |
|---|
set_query | Set or replace the boolean search expression. | session |
add_filter | Add a filter to the accumulated session state. | session |
remove_filter | Remove a filter value or clear an entire field. | session |
get_state | Return accumulated filters, query, index, and (optionally) the runtime query payload. | session |
clear_search | Clear accumulated search state and start a fresh search. | session reset |
browse_power_filters | Discover available filter options and values for the current vertical. | stateless |
Search execution
| Tool | Description | |
|---|
search_people | Execute a search using all accumulated session filters. | read-only |
count_results | Quick count of candidates matching current session filters. | read-only |
pipeline_overview | One-shot ATS pipeline summary by status, recruiter, and stage. | read-only |
unified_search | Search across multiple verticals in a single call. | read-only |
Entity resolution & profiles
| Tool | Description | |
|---|
search_entities | Look up an entity by name (autocomplete). | stateless |
search_entities_batch | Look up multiple entities at once. | stateless |
get_profile | Fetch full candidate profiles by profile key. | read-only |
get_search_links | Get a shareable link to the current search in SeekOut. | read-only |
Session management
| Tool | Description | |
|---|
set_index | Set the geographic search index. | session |
set_vertical | Switch to a different search vertical. | session |
Company discovery, search verification, and market analysis.
| Tool | Description | |
|---|
discover_companies | Find companies in an industry using AI and verify against SeekOut's entity database. | read-only |
verify_search | Verify search quality before rendering candidate results. | read-only |
market_analysis | Run structured market comparisons across dimensions. | read-only |
compare_markets | Compare a talent pool across up to 6 cities side-by-side. | read-only |
SeekOut Recruit workspace management. Everything done here syncs with Recruit, and vice versa.
| Tool | Description | |
|---|
list_workspaces | List your existing candidate workspaces. | read-only |
create_workspace | Create a new candidate workspace. | write |
add_to_workspace | Add candidates from search results to a workspace. | write |
update_workspace_search | Replace a workspace's base search with the current session. | write |
add_search_to_workspace | Save the current search as an additional saved search on a workspace. | write |
Retrieve contact information, export profiles, and push candidates to your ATS. Contact info retrieved via MCP is synced back to SeekOut Recruit.
| Tool | Description | |
|---|
get_emails | Retrieve verified email addresses for candidates. | credits |
get_phones | Retrieve phone numbers for candidates. | credits |
check_contacts | Check the status of a pending contact retrieval request. | read-only |
export_profiles | Export candidate profiles to Excel or Google Sheets. | credits |
export_to_ats | Push candidates directly to your connected ATS. | write |
list_ats_connections | List your organization's connected ATS integrations. | read-only |
check_credits | Check your remaining contact and export credits. | read-only |
Tenant-aware schema discovery, skill resolution, and bench analysis. Available for orgs with the relevant data sources connected.
| Tool | Description | |
|---|
describe_org_schema | Discover what's filterable in your organization's data. | read-only |
resolve_skills_for_org | Map free-text skill names to your org's actual vocabulary. | read-only |
analyze_bench_depth | Score successor / replacement candidates for a critical role. | read-only |
Workflow skills exposed via MCP resources. The assistant reads the relevant skill before starting a task and follows the prescribed steps. See Workflows for the full list.
| Tool | Description | |
|---|
list_resources | List all available skill resources and their URIs. | stateless |
read_resource | Load a skill resource by URI. | stateless |
