MCP Server

Testlify MCP Server Documentation

Your Testlify workspace, inside Claude.

Connect Claude to Testlify to manage assessments, invite candidates, and review results — directly from your AI workspace.

> Status: MCP Server · Live

Overview

The Testlify MCP Server is a Model Context Protocol (MCP) integration that lets AI assistants like Claude securely connect to your Testlify talent assessment platform. Once connected, you can browse assessments, search candidates, send bulk invitations, and retrieve scores and proctoring reports — all through natural language, without leaving your AI environment.

The server exposes 7 tools spanning read and write operations across assessments and candidates.

MCP Endpoint

https://mcp.testlify.com

How to Connect

Connecting takes three steps inside Claude:

Open Claude and go to Settings → Integrations.
Search for "Testlify" and click Connect.
Log in to Testlify and click Allow to authorize access to your workspace.

Once authorized, the Testlify tools become available to Claude automatically. Authentication is handled through Testlify's secure login — you never need to paste API keys or credentials into the chat.

> Manual setup: If your client supports custom MCP endpoints, add the endpoint URL above directly in your MCP server configuration.

Available Tools

The server provides 7 tools. Each is marked READ (retrieves data) or WRITE (creates or sends data).

Assessment Tools

| Tool | Access | Description | |------|--------|-------------| | testlify_get_all_assessments | READ | List assessments with filters, sorting, and pagination. | | testlify_get_single_assessment | READ | Get full configuration and details of one assessment. | | testlify_create_assessment_from_template | WRITE | Clone a reseller template into a new assessment. |

Candidate Tools

| Tool | Access | Description | |------|--------|-------------| | testlify_get_all_candidates | READ | Search candidates across all assessments in the workspace. | | testlify_get_candidate_list | READ | List candidates for a specific assessment with filters. | | testlify_get_candidate_result | READ | Retrieve scores, reports, and proctoring data. | | testlify_invite_candidates | WRITE | Send bulk assessment invitations (up to 100 candidates). |

Tool Reference

`testlify_get_all_assessments` — READ

Lists assessments in your workspace with support for filtering, sorting, and pagination. Use this to browse or locate assessments before drilling into details.

`testlify_get_single_assessment` — READ

Returns the full configuration and details of a single assessment, including its test composition and settings. Typically used after locating an assessment via testlify_get_all_assessments .

`testlify_create_assessment_from_template` — WRITE

Clones a reseller template into a brand-new assessment, ready to configure and use for an open role.

`testlify_get_all_candidates` — READ

Searches across every assessment in the workspace to find candidates. Useful for workspace-wide candidate lookups.

`testlify_get_candidate_list` — READ

Lists candidates for one specific assessment, with filters to narrow results (e.g., by status or stage).

`testlify_get_candidate_result` — READ

Retrieves a candidate's scores, detailed reports, and proctoring data to support hiring decisions.

`testlify_invite_candidates` — WRITE

Sends assessment invitations to up to 100 candidates in a single bulk operation.

Use Cases & Examples

Browse & Review Assessments

Tools: get_all_assessments , get_single_assessment

"List all active assessments sorted by creation date."
"Show me the full configuration and test composition of the Backend Engineer assessment."

Search & Track Candidates

Tools: get_all_candidates , get_candidate_list

"Find all candidates in the workspace who took a JavaScript test."
"List candidates for the Sales Manager assessment who are still pending."

Retrieve Results & Reports

Tool: get_candidate_result

"Get the scores and proctoring report for the top candidates on the Data Analyst assessment."
"Show me the full result breakdown for this candidate."

Spin Up New Assessments

Tool: create_assessment_from_template

"Create a new assessment from the Frontend Developer reseller template."
"Clone the Customer Support template into a new assessment for our open role."

Invite Candidates in Bulk

Tool: invite_candidates

"Invite these 50 candidates to the QA Engineer assessment."
"Send bulk invitations for the Product Manager assessment to my shortlist."

End-to-End Hiring Flow

Combining multiple tools

"Create a Backend Engineer assessment from a template, then invite my candidate list to it."
"Pull the candidate list for the SQL assessment, then retrieve results for everyone who scored above 80%."

Permissions & Security

Authentication is handled via Testlify's secure OAuth-style login flow. No API keys are entered into the chat.
READ tools only retrieve data and make no changes to your workspace.
WRITE tools (create_assessment_from_template , invite_candidates ) modify your workspace or send communications. Review these actions before confirming, especially bulk candidate invitations.
Access is scoped to the workspace you authorize during connection.

Troubleshooting

| Issue | Resolution | |-------|------------| | Tools not appearing in Claude | Confirm the connection shows as authorized under Settings → Integrations, then refresh. | | Authorization fails | Re-run the connect flow and ensure you click Allow while logged in to Testlify. | | Empty results | Verify you're connected to the correct workspace and that assessments/candidates exist for your filters. | | Bulk invite limit | A single invite_candidates call supports up to 100 candidates; split larger lists across calls. |