MCP

Agents: the full documentation index is at /llms.txt.

Coming soon. The Revcenter MCP server is not published yet, so the setup below won’t work until it is. Until then, an agent can call the API directly; see Agents.

revcenter mcp runs a Model Context Protocol server that gives your AI tool Revcenter as a set of tools. Your tool does the reasoning; Revcenter searches, scores, keeps the shortlist and exports.

Connect (once published)

Claude Code
Codex
Claude Desktop
Other clients

claude mcp add revcenter --env REVCENTER_API_KEY=<your key> -- npx -y revcenter mcp

In ~/.codex/config.toml:

[mcp_servers.revcenter]
command = "npx"
args = ["-y", "revcenter", "mcp"]
env = { REVCENTER_API_KEY = "<your key>" }

In claude_desktop_config.json:

{
  "mcpServers": {
    "revcenter": {
      "command": "npx",
      "args": ["-y", "revcenter", "mcp"],
      "env": { "REVCENTER_API_KEY": "<your key>" }
    }
  }
}

Any client that starts a local (stdio) MCP server: run npx -y revcenter mcp with REVCENTER_API_KEY set.

Restart the client after adding it. Ask it to “list my Revcenter projects” to check the connection.

Tools

Tool	What it does	Credits
`get_criteria_reference`	Every criteria field, filter or score, allowed values, an example	Does not use shortlist credits.
`find_industries`	LinkedIn industries and their ids for a word	Does not use shortlist credits.
`list_projects` · `create_project` · `get_project` · `list_searches`	Projects and their searches	Does not use shortlist credits.
`launch_search`	Start a search on criteria or a job description	Uses 1 shortlist credit per search; none with `database_only`.
`get_search` · `wait_for_search`	Status, stage and outcome; `wait_for_search` checks every 10 seconds (default timeout 600 s)	Does not use shortlist credits.
`list_people`	Everyone scored, best first, with their full profile	Does not use shortlist credits.
`preview_scoring_change` · `apply_scoring_change`	Cut-off, weights and requirements	Does not use shortlist credits.
`search_database`	Search your workspace’s candidates again	Does not use shortlist credits.
`expand_search`	A live pass for more people on the same role	Uses 1 shortlist credit per expansion.
`get_shortlist` · `download_shortlist_csv`	The shortlist as JSON, or saved as a CSV file on the machine running the server	Does not use shortlist credits.
`add_to_shortlist` · `remove_from_shortlist`	Edit the shortlist	Does not use shortlist credits.

Every tool’s description says whether it uses a shortlist credit, so your tool can ask you before it spends one. A tool that fails returns the API’s error code and message as an error result.

Hosted connectors

Connectors that need a hosted URL (for example custom connectors in a web chat app) are not available yet. Use a desktop or command-line client with revcenter mcp for now.

Get started

Concepts

Tools

Guides

Recipes

Use cases

API reference

Connect (once published)

Tools

Hosted connectors

​Connect (once published)

​Tools

​Hosted connectors

Connect (once published)

Tools

Hosted connectors