io.github.QueryQuarry/queryquarry

Official10 tools

by QueryQuarry · Dockerfile

Double-blind talent marketplace: AIs search anonymous opted-in candidates; reveal on consent.

Anonymous talent marketplace connecting AI agents with opted-in candidates for work.

Captured live from the server via tools/list.

search_candidates

Search the talent graph. Returns ANONYMOUS match cards — headline, skills, seniority, location, availability, salary range, and a short snippet — but NO name, full resume, or contact. Call get_candidate (a metered reveal) to unlock a specific person's identity, full resume, and contact. Filter by skills, location, seniority, salary, experience, availability, and more. Always paginated (max 25 per page).

Parameters (17)

skillsarray
Skills to match (any of). Case-insensitive partial match — use plain terms like "React", "Node", "Postgres"; they also match versioned/variant skills ("React 19", "Node.js", "PostgreSQL").
locationstring
City with state ("Schaumburg, IL") or a 5-digit zip ("60133" — most precise). Geocoded locally; combine with radius_miles for distance search. Unresolvable text falls back to substring match.
radius_milesnumber
With location: include candidates within this many miles (e.g. 5, 10, 25, 50; max 100). Omit for exact-place matching.
remote_okboolean
Only candidates open to remote/hybrid.
experience_years_minnumber
experience_years_maxnumber
availabilitystring
employment_typesarray
Engagement types to match (any of): full-time, part-time, contract, freelance, internship. Synonyms/variants are normalized.
work_location_typesarray
Work-location preferences to match (any of): remote, hybrid, onsite.
seniority_levelsarray
Seniority levels to match (any of): entry, junior, mid, senior, staff, principal, manager, director, executive.
work_authorizationstring
Filter by work authorization: "authorized" (no sponsorship needed) or "sponsorship-required".
open_to_relocationboolean
Only candidates willing to relocate for the right role.
salary_minnumber
salary_maxnumber
updated_sincestring
ISO timestamp — only resumes updated since.
pagenumber
1-based page.
limitnumber
Results per page (max 25).

get_candidate

Evaluate one candidate in depth — full skills, summary, seniority, experience (titles + what they did) and education. Stays ANONYMOUS: no name, no contact, and employer names, dates, and graduation years are withheld to protect identity. Counts toward your hourly/daily reveal limit. To actually reach someone, call request_contact.

Parameters (2)

candidate_idstringrequired
resume_idstringrequired

request_contact

Reach out to one candidate. You identify yourself (your name + company, from your account); the candidate is notified and decides. If they express interest, your account email + a unique code are shared with them and they reach out to you directly — their identity stays private until they choose to. METERED (counts toward your contact limit) and requires a prior get_candidate for this resume. One active offer per candidate; respect declines. Poll get_contact to see if they marked interest.

Parameters (3)

candidate_idstringrequired
resume_idstringrequired
messagestringrequired
Your pitch to the candidate: the role and why them. Your account email is AUTOMATICALLY attached and shown to them when they express interest, so you don't need to include it. You may optionally add other ways to connect (an application form link, your LinkedIn, etc.). Shown in-app, not your raw query.

get_contact

Check the status of a contact request you sent: sent (awaiting), accepted (the candidate is interested — they'll reach out to you directly, quoting the code), or declined. Identify it by contact_id or code.

Parameters (2)

contact_idstring
codestring

get_new_candidates

Get resumes new or updated since a timestamp (your standing alert). Same filters as search_candidates. Call daily with yesterday's timestamp; no duplicates.

Parameters (1)

sincestringrequired
ISO timestamp.

save_candidate

Save a candidate resume to your watchlist with optional notes.

Parameters (3)

candidate_idstringrequired
resume_idstringrequired
notesstring

get_watchlist

Get your saved candidates (watchlist).

Parameters (2)

statusstring
pagenumber

get_corpus_stats

Get aggregate stats about the talent corpus (counts, top skills/locations).

No parameters.

check_subscription

Check your subscription tier, status, rate limit, and usage this hour.

No parameters.

get_docs

Get the full QueryQuarry reference (how it works, all tools and filters, search tips, rate limits, privacy). Call this when you need detail beyond these tool descriptions, when guiding a new user, or before composing a complex search.

No parameters.

README.md4 KBView on GitHub

<p align="center"> <img src="https://queryquarry.com/QueryQuarry_Logo_192.png" width="96" alt="QueryQuarry logo — an amber gem" /> </p> <h1 align="center">QueryQuarry MCP Server</h1> <p align="center"> <b>The consent-based talent graph recruiters' AIs query directly.</b><br/> Search an anonymous corpus of opted-in candidates in natural language — identity is revealed only when the candidate chooses to respond. </p> <p align="center"> <a href="https://queryquarry.com">queryquarry.com</a> · <a href="https://queryquarry.com/docs/mcp">MCP docs</a> · <a href="https://queryquarry.com/blog">Blog</a> · <a href="mailto:hello@queryquarry.com">hello@queryquarry.com</a> </p>

QueryQuarry is a remote (hosted) MCP server for recruiters and sourcers. Instead of scraping or spraying InMails, your AI assistant queries a structured talent graph where every profile is explicitly opted in, candidates stay anonymous until they accept contact, and outreach happens through a double-blind escrow handshake.

Endpoint: https://queryquarry.com/api/mcp (streamable HTTP)
Auth: OAuth 2.0 — sign up at queryquarry.com, then connect your client and authorize
Server card: /.well-known/mcp/server-card.json

Connect

Claude (claude.ai / Claude Desktop): Settings → Connectors → Add custom connector → https://queryquarry.com/api/mcp

Any MCP client (via mcp-remote):

json

{
  "mcpServers": {
    "queryquarry": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://queryquarry.com/api/mcp"]
    }
  }
}

On first use you'll be sent through OAuth to link your recruiter account.

Tools

Tool	What it does
`search_candidates`	Search the talent graph. Returns anonymous match cards — headline, skills, seniority, location, availability, salary range. Rich filters: skills, location, remote, seniority, employment type, salary, experience, work authorization, relocation.
`get_candidate`	Evaluate one candidate in depth (full skills, experience, education) — still anonymous. Metered.
`request_contact`	Reach out: you identify yourself, the candidate is notified and decides. If interested, they contact you quoting a one-time code. Metered.
`get_contact`	Status of a contact request: sent, accepted, or declined.
`get_new_candidates`	Profiles new or updated since a timestamp — your standing alert.
`save_candidate` / `get_watchlist`	Watchlist management.
`get_corpus_stats`	Aggregate corpus stats — counts, top skills, top locations.
`check_subscription`	Your tier, limits, and usage.
`get_docs`	The full reference, served to your AI.

Full documentation: queryquarry.com/docs/mcp

search_candidates → anonymous match cards, ordered by recency.
get_candidate → deeper evaluation, still no name or contact info.
request_contact → the candidate is notified with your identity and message.
The candidate decides. If interested, they reach out to you with a one-time code. The platform never exposes a candidate's identity or contact details — consent is structural, not policy.

Pricing

Free accounts include an allowance of candidate reveals and contact requests. Paid plans: queryquarry.com/#pricing.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "queryquarry": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://queryquarry.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

search_candidates

get_candidate

request_contact

get_contact

get_new_candidates

save_candidate

get_watchlist

get_corpus_stats

check_subscription

get_docs

Connect

Tools

How the double-blind flow works

Pricing

Install