Bring HackerRank into yourAI workflow

Connect an approved AI client to HackerRank to review assessment activity, prepare interview briefs, and create recruiting reports from the data your account can access.

Set up HackerRank MCPExplore use cases
Available now · OAuth sign-in · Setup guides for Claude and Codex
One MCP, multiple agentsClaude Code · ChatGPT Codex
Ask naturally“Who needs follow-up this week?”
Decide with evidencePipelines · rankings · interview briefs
Safe by design45 read-only tools
Interactive network of HackerRank MCP tools
Introduction

HackerRank MCP

HackerRank MCP lets approved AI clients retrieve assessment, candidate, interview, team, and audit information from HackerRank. Recruiters and interviewers can review pipeline activity, prepare interview briefs, and create reports without changing HackerRank data.

This guide documents 45 customer-facing, read-only tools backed by HackerRank APIs. Configure the server at https://www.hackerrank.com/work/mcp.

Concepts

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI applications work with external products. HackerRank provides the MCP server; Claude Code or ChatGPT Codex is the client where you ask questions and give instructions.

1

Connect

Add the production URL to your preferred MCP client.

2

Sign in

Authenticate in your browser with your HackerRank account.

3

Ask

Use natural language; your assistant chooses the relevant HackerRank tools.

Built for your hiring team

One connection, role-specific workflows

Use the same HackerRank connection for the work that matters to your role.

Recruiters

Keep the pipeline visible

Review candidate progress, identify qualified candidates, track invites, and prepare weekly hiring updates.

Interviewers

Prepare and follow up

See upcoming interviews, retrieve interview details, and summarize transcripts and reports.

Developers

Understand assessment content

Inspect tests and questions, review available API operations, and retrieve structured data from versioned read endpoints.

Get started

Choose your MCP client

The server is live in production. Add it without an authorization header; your client will start OAuth sign-in when authentication is required.

Claude Code CLI

Add the server from your terminal, then authenticate from the /mcp menu.

→

Claude Code GUI

Add HackerRank as a remote connector, then enable it in your desktop Claude Code session.

→

ChatGPT Codex

Add the production URL in Settings, then use the Authenticate action.

→
Claude Code CLI

Connect from your terminal

Add the production server for your user account:

terminal / config
claude mcp add hackerrank \
  --scope user \
  --transport http \
  https://www.hackerrank.com/work/mcp
claude mcp addAdd and save the HackerRank server.
claude mcp listList every configured MCP server.
claude mcp get hackerrankInspect HackerRank's URL, transport, and scope.
/mcpRun inside Claude Code to authenticate, check connection status, view the tool count, retry, or clear authentication.
claude mcp remove hackerrankRemove the saved HackerRank server configuration.
  1. Run claude in your terminal to start Claude Code.
  2. Inside Claude Code, run /mcp.
  3. Find HackerRank. If it shows needs authentication, select it and press Enter.
  4. Complete the HackerRank sign-in in the browser window, then return to Claude Code.
  5. Open /mcp again and confirm that HackerRank shows as connected with its available tool count.
i

To change the server URL or scope, remove the HackerRank server and add it again with the new settings. Advanced Claude Code commands also include claude mcp add-json, claude mcp add-from-claude-desktop, and claude mcp reset-project-choices; they are not required for this hosted user-scoped setup.

Claude Code GUI

Connect from Claude Desktop

HackerRank is a hosted remote MCP server. Add it as a custom connector to make it available in Claude Desktop and your desktop Claude Code sessions.

  1. Open Claude Desktop and go to Customize → Connectors.
  2. Select +, then Add custom connector.
  3. Enter https://www.hackerrank.com/work/mcp as the remote MCP server URL. Leave the optional OAuth client ID and client secret empty.
  4. Select Add, then find HackerRank in the connector list and select Connect.
  5. Complete the HackerRank sign-in in your browser, then return to Claude Desktop.
  6. Start or open a Claude Code session. From the + menu, open Connectors and enable HackerRank for that session.
i

On Team and Enterprise plans, an Owner or Primary Owner must first add the connector from Organization settings → Connectors → Add → Custom → Web. Team members can then connect their own HackerRank account from Customize → Connectors.

For Claude account and organization-specific details, see Anthropic's remote custom connector guide.

ChatGPT Codex

Connect from ChatGPT Codex

Add the HackerRank production MCP directly in ChatGPT Codex.

  1. Open Settings → Plugins → MCP.
  2. Select Add Server and enter https://www.hackerrank.com/work/mcp.
  3. Return to the MCP list and select Authenticate next to HackerRank.
  4. Complete the HackerRank sign-in in your browser.
  5. Return to ChatGPT Codex and confirm that the server shows as connected.
Production serverhttps://www.hackerrank.com/work/mcp
Security

Authentication

HackerRank MCP uses OAuth. Do not add an authorization header when you configure the server. The first time your client connects, it will direct you to a browser to sign in to the production HackerRank environment.

  1. Add the production MCP URL to Claude Code or ChatGPT Codex.
  2. Start authentication from the MCP server list.
  3. Sign in from your browser, then return to your client.
  4. Confirm that HackerRank shows as connected before asking it to use HackerRank.
i

The current HackerRank MCP is read-only. Its dedicated tools and raw API request tool retrieve data through GET requests; they do not create, update, archive, invite, or delete HackerRank data.

Examples

Prompts to try

Copy any prompt below and edit it as needed.

Weekly recruiting update

“Create a weekly recruiting update from HackerRank for my active tests. Include invitations, attempts, completions, qualified candidates, and next actions.”

Interview preparation

“Show my upcoming HackerRank interviews this week and prepare a short briefing for each candidate.”

Candidate pipeline

“Summarize this test’s candidate pipeline in HackerRank by assessment status and ATS stage. Highlight candidates who need follow-up.”

Assessment audit

“In HackerRank, list the questions attached to this test and summarize the available details for each coding question.”

Interview review

“Review yesterday’s HackerRank interview transcript and report. Summarize strengths, concerns, and follow-up topics.”

Dashboard input

“Use HackerRank test activity and candidate outcomes to create a structured summary for a recruiting dashboard.”

Reference

Capabilities reference

All 45 read-only tools shown on this page, grouped by capability. This includes candidate, assessment, interview, team, question, invite template, and audit workflows.

Users

3 tools
LISTlist_users
List company users.
GETget_user
Get a user by ID.
SEARCHsearch_users
Search users by name or email.

Teams

4 tools
LISTlist_teams
List teams.
GETget_team
Get a team by ID.
LISTlist_team_members
List team members.
GETget_team_membership
Get a team membership.

Tests

5 tools
LISTlist_tests
List tests.
SEARCHsearch_tests
Search tests using the filters available in HackerRank.
GETget_test
Get a test by ID.
LISTlist_test_inviters
List inviters for a test.
GETget_test_questions
List questions attached to a test.

Candidates & pipeline

16 tools
SEARCHsearch_candidates
Search candidate summaries across accessible tests and interviews.
LISTlist_candidates
List candidates for a test.
SEARCHsearch_test_candidates
Search candidates within one test.
GETget_candidate_result
Retrieve a candidate’s assessment result and report.
GETget_candidate_report_pdf
Get the URL for a candidate report PDF.
GETget_candidate_by_email
Find a candidate by exact email within a test.
FILTERfilter_candidates_by_status
Filter candidates by assessment status.
FILTERfilter_candidates_by_ats_state
Filter candidates by ATS stage.
GETget_qualified_candidates
Find candidates who meet a test’s configured qualification criteria.
LISTlist_test_attempts
List test attempts with date and status filters.
RANKrank_test_candidates
Compare candidates using assessment scores and report evidence for human review.
FINDfind_candidates_needing_review
Find completed candidates awaiting review.
SUMMARIZEsummarize_test_pipeline
Summarize one test's candidate pipeline.
FINDfind_stale_invites
Find candidates whose invitations or attempts may need recruiter follow-up.
GETget_test_summary
Summarize candidate counts and scores for a test.
GETget_pipeline_overview
Summarize the pipeline across recent tests.

Interviews & preparation

9 tools
LISTlist_interviews
List CodePair interviews.
GETget_interview
Get interview details.
GETget_interview_transcript
Get an interview transcript.
GETget_interview_report
Fetch interview details and transcript together.
LISTlist_upcoming_interviews
List upcoming interviews.
FINDfind_unscheduled_codepair_candidates
Find qualified candidates without a CodePair interview.
SUMMARIZEsummarize_candidate_report
Summarize the assessment and interview evidence available for a candidate.
COMPAREcompare_candidate_results
Compare results for two to ten candidates.
PREPAREprepare_interview_packet
Prepare candidate context for an interviewer to review.

Interview templates

2 tools
LISTlist_interview_templates
List accessible interview templates.
GETget_interview_template
Get an interview template.

Questions

3 tools
LISTlist_questions
List questions using supported filters.
SEARCHsearch_questions
Search questions by keyword.
GETget_question
Get a question by ID.

Invite templates & audit

3 tools
LISTlist_invite_templates
List candidate invite templates.
GETget_invite_template
Get an invite template.
LISTlist_audit_logs
List account audit activity.
Coming soon

Learn with step-by-step videos

A video series will walk through practical HackerRank MCP workflows for recruiters, interviewers, and developers.

▶
Recruiter workflow

Automate weekly hiring updates

Turn assessment and candidate activity into a concise recurring update.

▶
Interviewer workflow

Prepare for upcoming interviews

Gather schedules, candidate context, transcripts, and reports.

▶
Reporting workflow

Create recruiting dashboards

Shape test and pipeline data into decision-ready dashboard inputs.