{"endpoint":"/public-mcp","method":"POST","transport":"MCP (Model Context Protocol) over HTTP — Streamable HTTP, stateless. No session is established; every request is self-contained and no mcp-session-id is issued.","protocol":"JSON-RPC 2.0","description":"Ask a natural-language question about this candidate. Answers are grounded in the candidate's canonical published profile — not inferred by the calling model.","auth":"none required — this endpoint is public","rate_limit":"30 requests per minute per IP for unauthenticated callers","headers":{"Content-Type":"application/json","Accept":"application/json, text/event-stream"},"tools":[{"name":"ask_candidate","description":"Ask a natural-language question about this candidate's skills, experience, or background.","arguments":{"question":"string (required) — natural-language question about the candidate","context":"string (optional) — caller context, e.g. \"ATS\", \"recruiter\", \"ai-agent\". Adjusts tone.","stream":"boolean (optional, default false) — stream the answer via MCP progress notifications"}}],"example":{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ask_candidate","arguments":{"question":"What is the candidate's experience with TypeScript?"}}},"related":{"same_answers_over_plain_http":"POST /query","machine_schema":"GET /openapi.json"}}