Cats MCP server

Connect Cats to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Cats MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the search candidates tool in Cats
  • Use the get contact tool in Cats
  • Use the delete job tool in Cats
  • Use the create candidate tool in Cats
  • Use the update candidate tool in Cats
  • Use the get company tool in Cats

Supported Tools

search_candidates

Search Candidates

Search for candidates using full-text keyword search or advanced filters. Use **query** for keyword/boolean search across all indexed fields including resumes. Use **filters** for structured field-level filtering with operators like `exactly`, `contains`, `between`, `greater_than`, `less_than`, `is_empty`, and `geo_distance`.

get_contact

Get Contact

Retrieve a single contact record by ID with full details including company association.

delete_job

Delete Job

Permanently delete a job order from CATS. This action cannot be undone.

create_candidate

Create Candidate

Create a new candidate record in CATS. Supports setting contact info, address, employment details, skills, and availability. Optionally checks for duplicates before creating.

update_candidate

Update Candidate

Update an existing candidate record. Only provide the fields you want to change. Supports updating contact info, address, employment, skills, and other profile details.

get_company

Get Company

Retrieve a single company record by ID with full details.

list_users

List Users

List all user accounts associated with the CATS site. Useful for finding user IDs when assigning tasks, owners, or recruiters.

change_job_status

Change Job Status

Change a job to a status discovered with list_job_statuses. Omitted triggers use the provider defaults.

list_tags

List Tags

Discover existing CATS tag IDs and titles before updating record tags.

get_candidate

Get Candidate

Retrieve a single candidate record by ID. Returns full candidate details including contact info, address, employment, skills, and metadata.

list_tasks

List Tasks

List tasks with pagination.

update_contact

Update Contact

Update an existing contact record. Only provide the fields you want to change.

update_company

Update Company

Update an existing company record. Only provide the fields you want to change.

create_pipeline

Create Pipeline

Add a candidate to a job order pipeline. This creates the candidate-job relationship and begins tracking the candidate's progress through the hiring workflow.

create_contact

Create Contact

Create a new contact (individual at a company) in CATS. Contacts are linked to companies and represent your client-side relationships.

get_site

Get Site

Inspect the CATS site associated with the connected API key.

create_job

Create Job

Create a new job order in CATS. Set the title, description, salary, location, company association, department, and other job details.

get_job

Get Job

Retrieve a single job order by ID. Returns full job details including title, description, salary, location, and company association.

get_task

Get Task

Retrieve a single task by ID.

search_companies

Search Companies

Search for companies using keyword search or advanced filters.

delete_task

Delete Task

Delete a task by its ID from list_tasks or create_task.

search_contacts

Search Contacts

Search for contacts using keyword search or advanced filters.

log_activity

Log Activity

Log a new activity (call, email, meeting, text, or other) against a candidate or contact. Optionally link the activity to a specific job order.

update_task

Update Task

Update an existing task. Use this to change the description, due date, priority, assignment, or mark a task as completed.

list_workflow_statuses

List Workflow Statuses

Discover status IDs and attached triggers for a hiring workflow.

list_job_statuses

List Job Statuses

Discover site-wide job status IDs before calling change_job_status.

list_activities

List Activities

List activities with pagination. Returns recent activities across all records.

delete_pipeline

Delete Pipeline

Remove a candidate from a job order pipeline.

list_workflows

List Workflows

Discover hiring workflow IDs, titles, and the default workflow.

delete_candidate

Delete Candidate

Permanently delete a candidate record from CATS. This action cannot be undone.

get_pipeline

Get Pipeline

Retrieve a pipeline entry showing a candidate's status within a job order. Returns the candidate-job relationship details, current status, and rating.

get_activity

Get Activity

Retrieve a single activity record by ID.

search_jobs

Search Jobs

Search for job orders using full-text keyword search or advanced structured filters. Use **query** for keyword search or **filters** for field-level filtering with operators like `exactly`, `contains`, `between`, etc.

update_pipeline_status

Update Pipeline Status

Change a candidate's workflow status within a job pipeline. Optionally fire status triggers configured in CATS. Also supports updating the candidate's rating.

delete_company

Delete Company

Delete a company by its ID from search_companies.

create_task

Create Task

Create a new task in CATS. Tasks can be assigned to users, prioritized, and optionally associated with a candidate, contact, company, or job.

list_candidates

List Candidates

List candidate records with pagination. Returns a summary of each candidate.

manage_tags

Manage Tags

Get or update tags on a candidate, contact, company, or job. Use **action** "get" to retrieve current tags, "add" to append tags, or "replace" to replace all tags.

create_company

Create Company

Create a new company (client organization) record in CATS. Companies represent the organizations your agency works with.

list_pipelines

List Pipelines

List candidate-job relationships with their current workflow and status IDs.

delete_contact

Delete Contact

Delete a contact by its ID from search_contacts.

update_job

Update Job

Update an existing job order. Only provide fields you want to change.

Connect Cats to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Cats in Metorial. In your Metorial portal, enable the Cats MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Cats tools.

Run Cats through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Cats and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Cats tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Cats

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Technical notes for Cats

Manage candidates, job orders, companies, contacts, hiring pipelines, activities, tasks, and tags in CATS. Search recruiting records with keyword queries or structured filters, discover workflows and statuses, and inspect the connected site.

Frequently asked questions

Common questions about connecting Cats to AI agents with Metorial.

  1. How many tools does the Cats MCP server have?
    The Cats MCP server exposes 42 tools, including Search Candidates, Get Contact, Delete Job. Each one is governed and traced through Metorial.
  2. Cats exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Cats MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Cats and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Cats MCP server yourself or use the hosted gateway.

Connect Cats to production AI agents

See how Metorial gives your team governed access to Cats, with tracing and security controls built in.