Odel
korture mcp

korture mcp

@skprasad-kortureDeveloper ToolsTypeScriptUpdated 1w ago

Behavioural hiring briefs from any JD: 5 behaviours, evidence, demand, interview questions, rarity.

Server endpointStreamable HTTP

This is the third-party server itself — Odel doesn't run it. Hitting this URL directly talks straight to the upstream server with no auth or proxying. Connect through Odel to front it with managed auth.

Korture Hiring MCP

Korture Hiring is a remote MCP server that turns a job description into a behavioural measurement brief. Paste a JD into Claude, ChatGPT, Cursor, or any MCP-compatible client, and get back the five behaviours that actually matter for the role, the evidence each was picked from, demand levels from 1 to 5, and interview questions tied to every behaviour.

Most AI hiring tools rewrite your JD or guess at "culture fit". This one does not. It is built on Korture Science, evidence-tied, anti-horoscope, every number traceable. The brief tells you what to measure, why, and how to test for it on the call.

It also does the thing your AI assistant cannot do alone. It runs a population reality check against the labour market and tells you how rare this hire actually is, and whether you will find them. If you are searching for a unicorn, you find out before you post.

Free to use with a Korture account. Sign in at korture.com to get a key.

Endpoint: https://mcp.korture.com/api/mcp

Available tools

ToolPurpose
validate_jdConfirm the JD has enough signal to analyse. Always call this before create_brief.
create_briefTurn the JD plus three sharpening answers into a behavioural measurement brief: 5 behaviours, evidence per behaviour, demand levels (1 to 5), interview questions.
enrich_briefAdd depth to an existing brief: dynamic dimension profiles and a population reality check.
get_briefRetrieve a previously generated brief by id.
get_dimensionsList the 15 behavioural dimensions Korture can measure.
get_external_population_checkStratified reality check against a 145k-person external pool, filtered by country, education, and age band.
get_statsAggregate stats about the public Korture corpus.

What happens after you have a brief

The brief lives at https://hire.korture.com/brief/{brief_id}. Every create_brief, enrich_brief, and get_brief response includes a next_steps block with that link plus a link to the candidates page, where you add candidates, copy each assess link, and send it to the person. Candidates complete the assessment, results appear back on the brief page.

The MCP tools cover the brief side of the journey. The send-to-candidates and review-results steps live on korture.com, which is where the rest of the work happens.

Connecting from Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "korture-hiring": {
      "url": "https://mcp.korture.com/api/mcp"
    }
  }
}

Quit Claude Desktop fully and reopen. The connector appears in your tray.

First time you connect

The connector requires a Korture account. After you add it, Claude Desktop shows a Connect button on its connectors page. Click it. You will be sent to hire.korture.com to authenticate via email OTP, no password. Authentication takes about 20 seconds.

Once you finish, return to Claude Desktop. All seven tools become available. Your account is remembered until you revoke it from the connectors page.

After you have a brief

Every successful create_brief, enrich_brief, and get_brief response includes a next_steps block with two URLs:

  • next_steps.view_brief — the brief on korture.com
  • next_steps.add_candidates — the page where you add candidates and copy per-candidate scan links to send

Claude will surface these to you at the end of the response. Open them in your browser to continue the workflow.

If you previously connected to https://korture-mcp-server.vercel.app/api/mcp, update the URL above and re-authenticate. The old URL still serves traffic via a redirect, but the canonical address from now on is mcp.korture.com.

Connecting from Cursor (one click)

Add to Cursor

Click the button above in a browser that has Cursor installed. Cursor opens with the server name and URL pre-filled, you confirm and save.

Connecting from ChatGPT and other MCP clients

Any MCP client that supports remote Streamable HTTP servers will work with the same URL: https://mcp.korture.com/api/mcp. ChatGPT desktop and the official ChatGPT app directory entry both use this address.

Authentication

The server participates in OAuth 2.1 with PKCE (RFC 6749 + 7636, per the MCP spec). It advertises:

  • https://mcp.korture.com/.well-known/oauth-protected-resource — resource metadata (RFC 9728)
  • https://hire.korture.com/.well-known/oauth-authorization-server — authorization server metadata (RFC 8414)
  • Dynamic Client Registration at https://hire.korture.com/api/oauth/register (RFC 7591)

MCP clients that implement DCR register themselves automatically. For service-to-service callers, an internal-tier API key is available on request.

Rate limits are tier-based. Internal and admin tiers are unlimited; the free tier is 10 briefs per day. The MCP server does not accept unauthenticated calls.

Source and deployment

  • Code: api/mcp.ts, a thin stateless wrapper around hire.korture.com/api/v1/*
  • Runtime: Vercel Functions (Streamable HTTP transport, no session id required)
  • License: Apache-2.0

The MCP server contains no scoring logic, no prompts, and no dimension definitions. All behavioural analysis happens upstream in the Korture core system, so this repo is safe to fork or audit publicly.

Contributing

Issues and PRs welcome. For security disclosures, email security@korture.com rather than opening a public issue.