Documentation

fyndr connector for Claude

The fyndr connector is a remote MCP server that lets you work with your fyndr recruiting data from Claude — search jobs, review candidates, and draft recruiting content in a conversation. It is read-only: the connector can never create, edit, or delete anything in fyndr.

Prerequisites

Connecting in Claude

  1. In Claude, open Settings → Connectors and choose Add custom connector.
  2. Enter the server URL:
    https://talent.thefyndr.com/api/mcp
  3. Claude registers itself automatically and opens the fyndr sign-in page. Sign in with Google or your fyndr credentials.
  4. Review the consent screen — it lists exactly what the connector can access — and click Approve. You are returned to Claude with the connector active.
  5. The connector’s tools are now available in your conversations.

Authentication

The connector uses OAuth 2.0 — authorization code flow with PKCE (S256) and dynamic client registration (RFC 7591). Discovery metadata is published at /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource. Access tokens are JWTs that expire after one hour; there are no refresh tokens. Authorization codes are single-use and expire after five minutes. To revoke access, remove the connector in Claude’s connector settings.

Tool reference

search_jobsread-onlyAny connected account

Search and list job postings. Returns title, location, type, salary range, and deadline.

queryoptional — match against the job title
typeoptional — full-time | part-time | contract | remote
locationoptional — partial match on location
statusoptional — open (default) | draft | closed
limitoptional — 1–50, default 10
get_jobread-onlyAny connected account

Get the full details of one job posting, including description and requirements.

job_idrequired — the job's ID, as returned by search_jobs
list_candidatesread-onlyCompany & admin accounts only

List job-seeker profiles that have completed onboarding. Returns name, location, and top skills. Contact details are not exposed through the connector.

skills_filteroptional — comma-separated skills, e.g. "React,Node.js"
limitoptional — 1–50, default 20
match_candidates_to_jobread-onlyCompany & admin accounts only

Rank job-seeker profiles against a specific job by skill overlap. Returns the top matches with a score, their skills, and their most recent role.

job_idrequired — the job to match against
top_noptional — 1–20, default 5
generate_job_descriptionread-onlyCompany & admin accounts only

Draft a plain-text job description with AI. Returns text only — nothing is saved to fyndr.

titlerequired — the job title, e.g. "Senior React Engineer"
contextoptional — key requirements, tech stack, or notes to include
generate_interview_questionsread-onlyCompany & admin accounts only

Draft 12 tailored interview questions for a role (technical, behavioral, problem-solving, culture-fit, scenario). Returns text only — nothing is saved to fyndr.

job_idoptional — pull the role from an existing job
job_titleoptional — used if job_id is not provided
job_descriptionoptional — used if job_id is not provided
requirementsoptional — list of requirement strings

Data handling

Privacy policy

The full policy is at talent.thefyndr.com/privacy. Summary as it applies to this connector:

Rate limits

AI generation tools are limited to roughly 30 calls per hour per user. Read tools are not rate-limited beyond normal fair-use protection. Result sets are capped (job and candidate lists default to 10–20 items, max 50).

Support

Email info@thefyndr.com with connector issues. Include the tool name and roughly when the request failed.

Privacy PolicyAll docs