{
  "markdown": "# Korture Hiring MCP\n\nKorture Hiring is a remote MCP server for hiring managers. Tell it what you\nwant the person to get done, what the team is like, and how the place runs.\nIt reads the role back to you and answers the question you actually have:\nwho is likely to be wired for this, and are there enough of them.\n\nIt reads a role through four plain facets:\n\n- **The work.** What the job is at its core: hands-on, solving hard problems,\n  or creating.\n- **The team.** How much of it runs through other people.\n- **The drive.** How much leading and persuading it asks for.\n- **The culture.** Whether it runs on structure and exactness, or loose and\n  fast.\n\nEach facet says where the role sits and where people suited to this kind of\nwork usually sit, on one scale drawn from a real population. Where the role\nasks for more than those people normally bring, that is the rare part, and it\nis the reason a search stalls.\n\nThen it counts. About 1 in how many people are wired for this role, measured\nagainst real people rather than against other job titles. If that number is\nsmall, it shows you what each make-or-break part is costing you: take this one\noff and about 1 in 7 becomes about 1 in 5. The preview is honest, so it will\nalso tell you when a change makes the role narrower, or changes nothing.\n\nWhen the role is already reachable, it moves you on: mint the scan link for\ncandidates, and pull the structured interview for the role.\n\nFree to use with a Korture account. Sign in at\n[korture.com](https://www.korture.com).\n\n**Endpoint:** `https://mcp.korture.com/api/mcp`\n\n## Available tools\n\n| Tool | Purpose |\n| --- | --- |\n| `read_the_role` | Is what you have said enough to read the role from, what is missing, and what to go and ask. Call it before `create_brief`. |\n| `create_brief` | Read the role into the nine behavioural demands: how critical each is, which are make or break, the wording each came from, and a \"Will they ___?\" question per hard part. |\n| `get_brief` | The finished brief. Also the tool you poll while one is generating. |\n| `read_the_people` | The four facets, about 1 in how many people are wired for the role, and what each make-or-break part would do to that if it came off. |\n| `get_playbook` | The structured interview for the role: competencies from this job, questions, and what a strong, mixed or weak answer sounds like. |\n| `start_scan` | The link a candidate opens to do their scan. |\n| `get_scan_result` | The read on one candidate. |\n\n## What it costs\n\nA credit covers one of three things: a new role, a change to a role, or a\ncandidate finishing a scan. Your first role is free. Reading anything, a\nbrief, a role read, an interview or a candidate, is always free.\n\nRunning out of credits stops you adding a role. It never stops a candidate\nmid-scan and never puts a result behind a paywall.\n\n## What the numbers are not\n\nThe band on a candidate says how congruent that person is with **this** role.\nIt is not a grade on the person and not a ranking against other candidates.\nDifferent never means worse. The tools return the read in words for that\nreason, and an assistant reading them out should not turn them into a score.\n\n## Connecting from Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"korture-hiring\": {\n      \"url\": \"https://mcp.korture.com/api/mcp\"\n    }\n  }\n}\n```\n\nQuit Claude Desktop fully and reopen. The connector appears in your tray.\n\n### First time you connect\n\nThe connector requires a Korture account. After you add it, Claude Desktop\nshows a **Connect** button on its connectors page. Click it. You will be\nsent to `hire.korture.com` to authenticate via email OTP, no password.\nAuthentication takes about 20 seconds.\n\nOnce you finish, return to Claude Desktop. All seven tools become available.\nYour account is remembered until you revoke it from the connectors page.\n\n### After you have a brief\n\nEvery brief-shaped response carries a `links` block:\n\n- `links.overview`: the brief on korture.com\n- `links.role_shape`: the four facets, and where a change to the role is\n  actually applied\n- `links.candidates`: candidates and their results\n- `links.playbook`: the structured interview\n\nThe assistant will surface these at the end of a response. `read_the_people`\ntells you what a change would do; applying it is a decision, so it happens on\nthe role shape page rather than in a chat.\n\nIf you previously connected to `https://korture-mcp-server.vercel.app/api/mcp`,\nupdate the URL above and re-authenticate. The old URL still serves traffic via\na redirect, but the canonical address from now on is `mcp.korture.com`.\n\n## Connecting from Cursor (one click)\n\n[![Add to Cursor](https://cursor.com/deeplink/mcp-install-light.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=korture-hiring&config=eyJ1cmwiOiJodHRwczovL21jcC5rb3J0dXJlLmNvbS9hcGkvbWNwIn0=)\n\nClick the button above in a browser that has Cursor installed. Cursor opens\nwith the server name and URL pre-filled, you confirm and save.\n\n## Connecting from ChatGPT and other MCP clients\n\nAny MCP client that takes a remote Streamable HTTP server URL works with the\nsame address: `https://mcp.korture.com/api/mcp`.\n\n- **ChatGPT.** Add it as a custom connector. That needs developer mode on a\n  paid plan.\n- **Gemini Enterprise.** Add an MCP server under connected apps, with the URL\n  and your OAuth details.\n- **Cursor.** The one-click button above.\n\nThe server implements the 2026-07-28 protocol and serves 2025-era clients from\nthe same endpoint, so it works whichever revision your client speaks.\n\n## Authentication\n\nThe server participates in OAuth 2.1 with PKCE (RFC 6749 + 7636, per the MCP\nspec). It advertises:\n\n- `https://mcp.korture.com/.well-known/oauth-protected-resource`: resource metadata (RFC 9728)\n- `https://hire.korture.com/.well-known/oauth-authorization-server`: authorization server metadata (RFC 8414)\n- Dynamic Client Registration at `https://hire.korture.com/api/oauth/register` (RFC 7591)\n\nMCP clients that implement DCR register themselves automatically. For\nservice-to-service callers, an internal-tier API key is available on request.\n\nRate limits are tier-based. Internal and admin tiers are unlimited; the\nfree tier is 10 briefs per day. The MCP server does not accept unauthenticated\ncalls.\n\n## Source and deployment\n\n- Code: [`api/mcp.ts`](api/mcp.ts), a thin stateless gateway to `hire.korture.com/api/v1/*`\n- SDK: `@modelcontextprotocol/server` v2 (the 2026-07-28 specification)\n- Runtime: Vercel Functions, Streamable HTTP, stateless\n- License: Apache-2.0\n\nThe MCP server holds no scoring logic, no prompts, and no demand definitions.\nEvery tool forwards to the same REST API the product itself uses, so the\nanswers here and the answers on screen cannot drift apart. That also makes\nthis repo safe to fork or audit publicly.\n\n## Contributing\n\nIssues and PRs welcome. For security disclosures, email\n`team@korture.com` rather than opening a public issue.\n",
  "bytes": 6991,
  "sha": "a697974340b2b324d2e05e2e04e92e76f84656df3ab79613d389fa7566097e35",
  "repo_slug": "skprasad-korture/korture-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_korture_hiring_fb660f40/readme"
}