Workorai MCP server
online · 100% uptimeio.github.work0r-ai/workorai·v0.4.3WorkorAI talent marketplace MCP: candidate job search and employer hiring with explainable matching
0 stars
Reviews
Write oneNobody has reviewed Workorai yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Workorai tools (29, 6 write)
write = sends, deletes, buys or postscandidate.accept_invitationFreeAccept an employer's invitation to a job (INVITED -> APPLIED). Idempotent — accepting an already-accepted invite succeeds. Returns NOT_INVITED when there is no open invitation (e.g. already withdrawn/declined), and NOT_FOUND when the job/invite is not found or the job is no longer public.
candidate.apply_to_jobFreeApply the candidate to a PUBLISHED job, reusing their evaluated profile interview as evidence. Idempotent (re-applying succeeds; `reused` is true when an application row already existed). Requires a completed + evaluated interview — otherwise returns GATE_LOCKED / GATE_EVALUATING / GATE_FAILED. A missing or non-public job returns NOT_FOUND.
candidate.decline_invitationFreeDecline an employer's invitation to a job (INVITED -> DECLINED). TERMINAL — a declined invite blocks any re-invite from the employer, so only decline when the candidate is sure. Idempotent (declining again succeeds). Returns NOT_INVITED when there is no open invitation, NOT_FOUND when the job/invite is not found.
candidate.get_applicationsFreeList the candidate's own job applications (newest first) with status, dates, the originating interview score, and a job summary. Returns only the caller's applications — no jobId input, so it is not an enumeration surface.
candidate.get_jobFreeFetch a single published job by id.
candidate.get_saved_jobsFreeList the candidate's saved (bookmarked) jobs, newest first. Only currently PUBLISHED jobs are returned — a job saved earlier then closed/archived is omitted.
candidate.search_jobsFreeSemantically rank published jobs against the authenticated candidate profile (embedding-based fit). Optional tier (best|good|weak) narrows to a match-quality band — start with tier:'best' for the strongest fits and cascade only if needed; omit for the full ranked list (read tierCounts for the band sizes). Each scored row carries matchExplanation (the white-box 'why': fit score, the candidate's skills that match the job's required set, and a rationale). A free-text `q`, or a candidate who has not completed an interview yet, instead browses published jobs by recency — those rows carry NO fit score (`matchScore` is `null`, no bands); treat them as a browse list, not a ranking.
candidate.set_saved_jobFreeSet whether a PUBLISHED job is in the candidate's saved list (idempotent desired-state, NOT a toggle — pass saved:true to bookmark, saved:false to remove). Returns NOT_FOUND for a missing or non-public job.
candidate.withdraw_applicationFreeWithdraw the candidate's active application to a job (APPLIED -> WITHDRAWN). Idempotent (withdrawing again succeeds). Returns NOT_APPLIED when there is no active application (e.g. only an open invitation, or already declined), and NOT_FOUND when no application exists for the job.
employer.archive_jobFreeTransition a CLOSED job to ARCHIVED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in CLOSED.
employer.cancel_invitationwrite actionFreeCancel a pending invitation sent to a candidate. The invitation record is deleted; the employer can re-invite the same candidate later.
employer.close_jobFreeTransition a PUBLISHED job to CLOSED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in PUBLISHED.
employer.create_jobwrite actionFreeParse raw text via Gemini AI and create a DRAFT job under the current employer. Synchronous: latency 5-30s. The agent can then call employer.update_job to refine fields and employer.publish_job to make it live.
employer.delete_jobwrite actionFreePermanently delete a DRAFT job that was never published. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in DRAFT.
employer.get_applicant_detailFreeFull applicant bundle: resume, interview light slice (overallScore + summary + facts), GitHub analysis, LinkedIn analysis. The verbatim transcript is delivered by employer.get_applicant_transcript; the resume's contact fields are blanked unless the application is SHORTLISTED or HIRED.
employer.get_applicant_transcriptFreeVerbatim interview transcript for one applicant. Ownership-only gate (same as the UI Download button — no SHORTLISTED/HIRED requirement). Returns an empty array when the source interview never produced turns.
employer.get_candidateFreeFetch a discoverable candidate by user id. Returns search-entry shape plus a light interview slice (overallScore + summary + completedAt + evaluatedAt) and `existingApplications`: every JobApplication this candidate has on any of the employer's jobs (all 4 statuses, all 4 job statuses) so the agent can decide whether re-inviting will succeed. Heavy artefacts (transcript, facts, resume, github, linkedin) live behind employer.get_applicant_detail and require an application.
employer.get_candidate_evidenceFreeFetch the interview EVIDENCE (facts proven in the interview + their Q&A, the interview summary, the résumé summary, and GitHub/LinkedIn signals) for ONE candidate AGAINST one of your published jobs — the white-box basis to explain WHY a candidate ranks where they do. Use it AFTER search_candidates_for_job: shortlist with the scorecard, then read the evidence here for the few you care about and write your own comparative review. Returns NOT_FOUND if the job is missing / not yours / not published, or the candidate is not in that job's searchable pool.
employer.get_jobFreeFetch a single employer job record by id. Returns NOT_FOUND for missing jobs and for jobs owned by another employer (no existence leak).
employer.invite_candidateFreeInvite a discoverable candidate to one of the employer's PUBLISHED jobs. Creates a JobApplication with status=INVITED. If a prior WITHDRAWN row exists for this (candidate, job) pair, the row is UPDATEd back to INVITED (re-invite is allowed after the candidate withdrew on their own). INVITED, APPLIED, and DECLINED rows still block with INVITE_BLOCKED: INVITE_NOT_ALLOWED. Inspect `existingApplications` on employer.get_candidate before calling to know which case applies. Returns INVITE_BLOCKED with one of several sub-reasons (JOB_NOT_FOUND, JOB_NOT_PUBLISHED, CANDIDATE_NOT_FOUND, NOT_DISCOVERABLE, INVITE_NOT_ALLOWED) when the invite cannot be created. A missing vacancy and a vacancy owned by another employer both return JOB_NOT_FOUND (you cannot tell them apart — anti-enumeration).
employer.list_applicantsFreeList the live (APPLIED) applicants on one of the employer's jobs. The candidate showcase + interview overallScore/summary are always returned; contact fields are only included when the application is SHORTLISTED or HIRED.
employer.list_invitationsFreeList the pending (INVITED) candidates on one of the employer's jobs — candidates who have been invited but have not yet accepted or declined.
employer.list_jobsFreeList jobs owned by the current employer account.
employer.publish_jobwrite actionFreeTransition a DRAFT job to PUBLISHED. Returns NOT_FOUND for missing or non-owner jobs and CONFLICT when the job is not in DRAFT.
employer.search_candidates_by_queryFreeFree-form semantic search across discoverable (interviewed) candidates with no job context. The query is embedded and candidates are ranked by semantic similarity — a preliminary search with no per-vacancy fit score (there is no vacancy to fit). For a scored ranking, use employer.search_candidates_for_job with a job id.
employer.search_candidates_for_jobFreeSemantically rank discoverable (interviewed) candidates against one of the employer's own jobs, with a per-candidate fit score AND a white-box explanation. WORKFLOW for finding the best hire: 1) call with tier:'best' to get the strongest candidates (cover the required skills + proven in interview), cascade to tier:'good' then tier:'weak' only if you need more (read tierCounts to decide; paginate within a band via page.hasMore, not page.total); 2) each row carries matchExplanation — the white-box 'why' (the fit score, the skills the candidate PROVED in their interview, what they're missing, and a plain-English rationale) — use it to explain your shortlist on OUR data, not a black box; 3) for the few you shortlist, call employer.get_candidate_evidence(jobId, userId) for the interview facts + Q&A to write a deeper comparative review. Omit tier for the full ranked pool (back-compat). Returns NOT_FOUND when the job is missing / owned by another employer (no existence leak), or NOT_INDEXED / NO_CATEGORIES when the job is not indexed for semantic search yet (re-save / republish, then retry).
employer.set_review_statuswrite actionFreeUpdate the employer review state on an application (NEW / REVIEWING / SHORTLISTED / REJECTED / HIRED). SHORTLISTED and HIRED unlock the candidate's direct contact in subsequent list_applicants / get_applicant_detail calls. WITHDRAWN applications surface as CONFLICT.
employer.update_jobwrite actionFreeUpdate the fields of an existing employer job. Accepts a partial whitelist; rawInput and dataSource are not editable (the wrapper auto-flips dataSource to USER_EDITED on every agent update). Non-owner reads return NOT_FOUND.
request_accessFreeUse when someone wants to find work/jobs (candidate) or hire/find candidates (employer) but the authenticated role tools are not usable yet. Explains role-specific onboarding (candidate profile interview, employer key generation), MCP key location, and next steps for both surfaces.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 1294ms20/20
- Tool poisoning29 tool descriptions checked15/15
- Auth qualityopen endpoint exposes 6 write-action tools with no auth3/15
- Maintenancelast push 84 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
Findings (1)
- highWrite-action tools reachable without authentication
auth.open-write
How Workorai compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 76/100
- higher than 53% of 3,470 Web search servers
- Tools
- 29
- the typical Web search server has 5
- Tools that change things
- 21%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Web search server answers 100%
- Response time
- 467 ms
- faster than 32% of 2,238 Web search servers
What its tools let an agent do: 18 read · 1 create · 4 change · 3 delete · 2 send or post · 1 run or deploy
Install Workorai in Claude Code, Cursor or VS Code
claude mcp add --transport http workorai https://workorai.com/mcp
What the publisher says
From the Workorai repository's README, as published. We do not edit it. Read it on GitHub
WorkorAI Agent Kit
WorkorAI Agent Kit packages the workorai Agent Skill and a zero-dependency installer for WorkorAI MCP talent marketplace workflows.
It supports both sides of the marketplace through one skill:
- Candidates ask prompts like найди мне работу, find me a job, or help me get hired; the skill guides them through onboarding, MCP key setup, and the candidate match tools.
- Employers ask prompts like найди кандидатов, hire developers, post a job, or review applicants; the skill walks through the 19-tool employer MCP surface (job lifecycle, candidate discovery, invitations, applicants review).
Both roles share one skill name (workorai) and one credential helper, with role-aware storage slots so a dual-role user can keep both keys.
Install
Install the skill and write MCP config for supported local agents:
npx @workorai/agent-kit installInstall for one client:
npx @workorai/agent-kit install --agent codex
npx @workorai/agent-kit install --agent claude
npx @workorai/agent-kit install --agent opencode
npx @workorai/agent-kit install --agent cursor
npx @workorai/agent-kit install --agent openclaw
npx @workorai/agent-kit install --agent qwen
npx @workorai/agent-kit install --agent antigravity
npx @workorai/agent-kit install --agent deepcodeUse a local development MCP endpoint:
npx @workorai/agent-kit install --endpoint http://127.0.0.1:3001/mcpFor isolated installer tests, set WORKORAIAGENTHOME to a temporary directory:
WORKORAI_AGENT_HOME=/tmp/workorai-agent-home npx @workorai/agent-kit installAfter install, restart the agent client and ask:
find me a jobWhat Is Included
- skills/workorai/SKILL.md - canonical Agent Skill (thin role router).
- skills/workorai/agents/openai.yaml - Codex/OpenAI-style UI metadata.
- skills/workorai/references/
- candidate-catalog.md - candidate tool mini-schemas
- candidate-recipes.md - candidate calling-order recipes (incl. the Agent Pick result presentation)
- candidate-troubleshooting.md - candidate-side error scenarios
- employer-catalog.md - 19 employer tool mini-schemas
- employer-recipes.md - hire / review / lifecycle recipes
- employer-troubleshooting.md - employer-side error scenarios
- auth-flow.md - candidate and employer onboarding + saved-key flow
- troubleshooting.md - cross-role MCP transport / saved-key issues
- skills/workorai/scripts/credential-store.mjs - role-aware consent-based local MCP key storage.
Supported Targets
The default install command installs a canonical copy at ~/.agents/skills/workorai and links or copies compatible client locations.
Commands
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Workorai: common questions
- Is Workorai MCP server safe?
- Mostly: it is graded B (76/100). Read the Workorai safety report
- How do I install Workorai?
- It runs remotely at workorai.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Workorai need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Workorai maintained?
- The last commit was 123 days ago (2026-07-04). The latest release is v0.4.3.
- Is Workorai up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Workorai?
- Servers from other publishers that do the same job: Clinicaltrialsgov MCP server, Jobseek MCP server and Workopia — Job Search MCP server.
- How does Workorai compare with other Web search MCP servers?
- safety score 76/100 (higher than 53% of 3,470 Web search servers); tools 29 (the typical Web search server has 5); tools that change things 21% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Workorai
Same job from other publishers: the closest match first, then the best rated.
- ClinicaltrialsgovSearch ClinicalTrials.gov: find studies, retrieve results, match patients to candidate trials.not reviewedEstablishedA
- JobseekSearch jobs and companies on Job Seek (jseek.co)not reviewedEstablishedA
- Workopia — Job SearchSearch 6.3M+ live jobs from companies' own career pages, plus resume tailoring & cover letters.not reviewedGrowingB