# HackerRank Work — how to use (mcp.ai)

Connect your HackerRank Work account and use 3 tools for developer tools straight from your AI agent. Connect with your own API key. HackerRank Work enables coding interviews and technical assessments, providing developers with challenges and real-time collaboration for data-driven hiring decisions.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hackerrank_work?ms=1787293680000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `hackerrank_work_companies_list`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hackerrank_work`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/hackerrank_work/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hackerrank_work/companies/list` — Tool to list all companies and their unique identifiers. Use when you need the company_unique_id for SSO metadata retrieval.
  - body: { path_hint?: string }
- `POST https://api.mcp.ai/api/hackerrank_work/sso/assertion/consumer/service` — Tool to consume SAML assertions. Use when receiving SAMLResponse and RelayState from the Identity Provider for SSO sign-in.
  - body: { relay_state?: string, saml_response?: string, company_unique_id: string, raise_on_http_error?: boolean, raw_saml_response_xml?: string }
- `POST https://api.mcp.ai/api/hackerrank_work/sso/sign/on/url` — Tool to get the SP-initiated SSO sign-on URL. Use when configuring SAML SSO with your identity provider.

## Example prompts
- "What can I do in HackerRank Work?"
- "Show me a summary of my HackerRank Work account"

## More
- Page: https://mcp.ai/hackerrank_work
- Agent spec (llms.txt): https://mcp.ai/hackerrank_work/llms.txt
- Postman collection: https://mcp.ai/hackerrank_work/postman.json