{"name":"io.github.workopia/workopia-mcp","slug":"workopia-mcp","title":"Workopia — Job Search","description":"Search 6.3M+ live jobs from companies' own career pages, plus resume tailoring & cover letters.","url":"https://mcp.market/server/workopia-mcp","rating":null,"grade":"B","score":77,"certified":false,"status":"active","category":"search","tags":["search"],"presence":{"score":44,"stars":316,"forks":21,"downloads_week":null,"last_push_at":"2026-08-31T05:28:13.000Z","license":"MIT"},"uptime":{"percent":100,"checks":28,"ok":28,"last_checked_at":"2026-09-27T12:36:07.014Z","last_ok_at":"2026-09-27T12:36:07.014Z","latency_ms":866},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/workopia/workopia-mcp","website":null,"version":"1.0.2","remotes":[{"type":"streamable-http","url":"https://workopia.io/api/mcp-jobs"}],"packages":[],"tools":[{"name":"cover_letter_tool","description":"Write a cover letter for a SPECIFIC job — TWO steps. STEP 1 (default; action omitted or 'prepare'): the server returns the job's JD and the candidate's background, plus writing instructions. YOU (the model) then WRITE the cover letter (250–350 words, specific to the role, mapping the candidate's real achievements to the JD — never fabricate). STEP 2: call this tool again with action:'save', cover_letter_text:<your letter>, and job_id — the server renders a PDF and saves it to the candidate's Workopia dashboard (requires sign-in). Use whenever the user asks for a cover letter for a specific job. Resolving job_id (same rules as tailor_resume_tool / job_detail_tool): pass the **Job Id** value from the most recent prior search/refine result VERBATIM; no placeholders like 'JOB_1' or '#1'. For STEP 1 supply ONE of job_id (preferred — server fetches the JD from Mongo) OR job_description, plus the candidate's resume via resume_text / resume_content / json_resume / user_profile.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"job_id":{"type":"string","description":"ID of a job from a prior search/refine result. Use the **Job Id** value from the prior search result's content text VERBATIM. Server fetches full JD from Mongo."},"job_description":{"type":"string","description":"Full JD text when the user pastes it directly (alternative to job_id)."},"job_title":{"type":"string","description":"Optional; used in the 'for <role> at <company>' confirmation line."},"company":{"type":"string","description":"Optional; used in the confirmation line."},"resume_text":{"type":"string","description":"User's resume content (plain text or JSON Resume as string)."},"resume_content":{"type":"string"},"json_resume":{"type":"object","description":"Optional JSON Resume object (basics/work/skills). Takes precedence over resume_text when both present.","additionalProperties":true},"user_profile":{"type":"object","description":"Optional main-site profile object; used as a fallback source for summary/skills/experience and for the cover letter header (firstName, lastName, email, phone, city, country).","additionalProperties":true},"user_email":{"type":"string","description":"If provided, server fetches the full Workopia profile for the cover letter header + writes the generated cover letter back to profile.applications[jobId].coverLetter."},"session_id":{"type":"string"},"action":{"type":"string","enum":["prepare","save"],"description":"Omit or 'prepare' = STEP 1 (server returns JD + background + instructions for you to write). 'save' = STEP 2 (pass cover_letter_text; server renders a PDF and saves it to the dashboard; requires sign-in)."},"cover_letter_text":{"type":"string","description":"STEP 2 only: the cover letter you wrote (plain text). The server renders it to PDF and stores it on profile.applications[job_id].coverLetter."},"cover_letter":{"type":"object","description":"Optional wrapper containing the same fields above (legacy shape).","additionalProperties":true},"parameters":{"type":"object","additionalProperties":true}},"additionalProperties":true}},{"name":"dashboard_tool","description":"Show the signed-in user's Workopia dashboard (saved, tailored, and applied jobs + latest resume). Requires OAuth. Default action is list; optional status_filter (all | saved | tailored | applied). Use whenever the user asks to recall their Workopia activity: 'my applications', 'what jobs have I saved / applied to / tailored', 'show my dashboard', 'where did I leave off'. Returns a secure link to open the full dashboard on the web.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"action":{"type":"string","enum":["list"]},"status_filter":{"type":"string","enum":["all","saved","tailored","applied"]}},"additionalProperties":true}},{"name":"job_detail_tool","description":"Render the full job-detail card for a specific job the user asks about. Use this whenever the user references a particular job from a prior search result — by number (#1, '1', 'first', 'the 3rd one', 'job 3'), by company name (partial or full, e.g. 'Morgan Stanley', 'Morstan'), by role/title phrase ('the analyst role', 'the credit risk one'), or by any 'show me this job' / 'tell me more about X' / 'view this role' style request. Resolving job_id from user reference: identify the right job from the most recent prior search/refine result (the numbered list you generated): (a) numeric/ordinal → the Nth job; (b) company name → substring match on Company field; (c) role/title phrase → substring match on Job Title field. Then pass that job's **Job Id** value from the prior search result's content text VERBATIM as job_id. Do NOT use a placeholder like 'JOB_1', '#1', or any synthetic id — only the real **Job Id** string from the prior result is server-valid. Required: job_id. OUTPUT BEHAVIOR: Render the response as a structured markdown card with the job's title (linked to the apply URL), company, location, salary, employment type, work mode, must-have skills, key requirements, highlights, and summary. Follow it with a brief next-step hint (e.g. 'Want to save it, find similar roles, ask about the company, or tailor your resume for this role?').","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"job_id":{"type":"string","description":"The id from a prior search result's job_cards[].card.id. Required."},"get_job_detail":{"type":"object","properties":{"job_id":{"type":"string"},"user_email":{"type":"string"}}},"user_email":{"type":"string"},"parameters":{"type":"object"}},"additionalProperties":true}},{"name":"job_tool","description":"Search jobs across 90+ countries by title, location, salary, remote/hybrid work mode, or employment type. Find roles in tech, finance, product, design, marketing, and every other vertical — aggregated from 1000+ ATS sources globally. Default action is search; use refine when the user asks for more matches or gives feedback on a prior result set; use save to bookmark a job for the signed-in user (requires OAuth). REFINE PROTOCOL (action=refine has THREE distinct modes): (1) Pure continuation / 'show me more' / 'next batch' / 'another set' / 'more like these': pass refine_recommendations.exclude_ids = the full array of **Job Id** values from the most recent search/refine result's content text (verbatim) + refine_recommendations.session_id = prior response's session_id if present. Server returns next 10 unique jobs. (2) 'Show me more like #N' / 'similar to the Atlassian one' / 'jobs like #2': pass refine_recommendations.liked_indexes = [N] (1-based position from prior numbered list) + exclude_ids + session_id. Equivalently you may pass refine_recommendations.liked_job_ids = [<that job's **Job Id** value verbatim>]. Server seeds the recommendation from that job's title/skills/company profile. (3) 'Less like #N' / 'no more N-style jobs' / 'avoid jobs like that': pass refine_recommendations.disliked_indexes = [N] (or disliked_job_ids = [<Job Id>]) + exclude_ids + session_id. Server suppresses similar jobs. All three modes: if you skip exclude_ids, the user sees duplicates — that's a failure. The handler layers exclude_ids with server-side AgentKit memory, so partial lists still work. NEVER invent 'JOB_1' / '#1' as job_id values — always use the real **Job Id** string from the prior result's content text. For detail requests (user asks about a specific job from the list, e.g. 'details for #1', 'show me this job', 'tell me more about <company>'), DO NOT call this tool — call job_detail_tool instead. That separate tool binds to the job-detail widget card so the full job card renders in chat. OUTPUT BEHAVIOR: Render the search results as a numbered markdown list, one line per job, in this exact compact format: `N. **[Job Title](View_Job_URL)** — Company · Location · Job Type · Compensation · Posted MMM DD`. Embed the View Job URL as a markdown link on the title (so the user can click to apply). Keep URLs intact — don't strip parameters. Skip a field entirely if it's missing — never print 'N/A' placeholders. The numbered list IS the canonical user-facing answer. REQUIRED follow-up: after the list, output EXACTLY these two sentences as two parallel questions (same pattern for action=search and action=refine): Sentence 1 — 'Would you like to see full details on any of these? Reply with the number (#1), the company name, or the role title.' Sentence 2 — 'Or would you like to refine the list — what should change (work mode, level, salary, sector)?' These two sentences must be separate and parallel; do NOT merge them into one 'detail ... or refine' clause (that buries the detail CTA). Both questions must be asked every time after a search or refine result. When the user replies referring to a specific job from the list, identify which job they mean and call job_detail_tool immediately. Identifying the job (use flexibly — users rarely type '#N' literally): (a) any numeric or ordinal reference ('#1', '1', 'first', 'the 1st', 'top one', 'job 3', 'the third') → the Nth job in your prior numbered list; (b) a company name, partial or full ('Morgan Stanley', 'Morstan', 'Capital One') → case-insensitive substring match on the Company field of the prior list, pick the first match; (c) a role/title phrase ('the analyst role', 'the credit risk one') → case-insensitive substring match on the Job Title field. If multiple jobs match, prefer the earliest. Only if no reasonable match exists, ask a one-line clarifying question. Then pass that job's **Job Id** value from the prior search result's content text VERBATIM as job_id to job_detail_tool / tailor_resume_tool / cover_letter_tool. Do NOT invent a placeholder like 'JOB_1' or '#1' — those are not server-valid IDs. For save, pass job_id + optional job_title/company/job_url in save_job. Put search fields in search_jobs or parameters; refine in refine_recommendations; save in save_job.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"action":{"type":"string","enum":["search","refine","save"],"description":"Optional; omitted = search. refine = after results/feedback; save = bookmark a job for the signed-in user."},"search_jobs":{"type":"object","description":"Search args. Required: city. Optional filters surface only when the user explicitly mentions them — omit otherwise. job_title+city uses indexed snapshot; company+city (optional job_title) uses legacy DB match.","properties":{"job_title":{"type":"string","description":"Target role title. Use this exact key name — do NOT send 'title' or 'role'."},"city":{"type":"string","description":"Target city name. Use this exact key name — do NOT send 'location' or 'locations'."},"workMode":{"type":"string","enum":["remote","onsite","hybrid"],"description":"Optional. Pass only when the user explicitly says 'remote' / 'onsite' / 'hybrid'. Do NOT pass 'all' or any placeholder — omit entirely if unspecified."},"employmentType":{"type":"string","enum":["fulltime","parttime","contract","internship","temporary","casual"],"description":"Optional. Pass only when the user explicitly says 'full time' / 'part time' / 'contract' / 'internship' / 'temporary' / 'casual'."},"workModeStrict":{"type":"boolean","description":"Optional. Set true only when the user says 'only remote' or similar absolute phrasing."},"sponsorship_only":{"type":"boolean","description":"Optional. Set true when the user mentions 'visa sponsorship', 'sponsors visa', or 'H-1B' (or local equivalent)."},"posted_within_days":{"type":"number","description":"Optional. Limit to jobs posted within the last N days. Common values: 3, 7, 14, 30."},"company":{"type":"string","description":"Optional. Target a specific company name."},"skills":{"type":"array","items":{"type":"string"},"description":"Optional. Skills the user has or wants in the role (e.g., ['Python', 'AWS'])."}}},"refine_recommendations":{"type":"object","description":"Refine args. Pass exclude_ids (array of Job Id strings from prior result) and session_id always. For 'more like #N': pass liked_indexes=[N] or liked_job_ids=[<Job Id>]. For 'less like #N': pass disliked_indexes=[N] or disliked_job_ids=[<Job Id>]. job_title/city optional — auto-filled from prior search via session memory.","properties":{"exclude_ids":{"type":"array","items":{"type":"string"},"description":"Job Id strings from prior result to exclude from this round."},"session_id":{"type":"string","description":"Prior response's session_id, for memory continuation."},"liked_indexes":{"type":"array","items":{"type":"number"},"description":"1-based positions from prior numbered list to use as seed (e.g. [1] = 'more like #1')."},"liked_job_ids":{"type":"array","items":{"type":"string"},"description":"Job Id strings to use as seed (alternative to liked_indexes)."},"disliked_indexes":{"type":"array","items":{"type":"number"},"description":"1-based positions to suppress similar to."},"disliked_job_ids":{"type":"array","items":{"type":"string"},"description":"Job Id strings to suppress similar to."},"job_title":{"type":"string"},"city":{"type":"string"}}},"save_job":{"type":"object","description":"Save args. Required: job_id (from job_cards[].card.id in a prior search result). Optional: job_title, company, job_url.","properties":{"job_id":{"type":"string"},"job_title":{"type":"string"},"company":{"type":"string"},"job_url":{"type":"string"}}},"parameters":{"type":"object"}},"additionalProperties":true}},{"name":"tailor_resume_tool","description":"Tailor a resume to a SPECIFIC job — TWO steps. STEP 1 (default; action omitted or 'prepare'): the server returns the job's full JD, its must-have skills/requirements, and the candidate's current resume, plus tailoring instructions. YOU (the model) then WRITE the tailored resume as JSON Resume, following the instructions — weave JD keywords into existing bullets only where the candidate genuinely has the experience, never fabricate experience/titles/dates/employers, keep all dates and company names, and flag any keyword you couldn't honestly add. STEP 2: call this tool again with action:'save', tailored_resume:<your JSON Resume>, and job_id — the server renders a PDF and saves it to the candidate's Workopia dashboard (requires sign-in). Use whenever the user references a specific job to tailor for: 'tailor for #1', 'for Morgan Stanley', 'tailor my resume for this role: <JD>'. Resolving job_id (same rules as job_detail_tool): from the most recent prior search/refine result — (a) numeric/ordinal → the Nth job; (b) company name → Company-field match; (c) role/title phrase → Job-Title match — then pass that job's **Job Id** value VERBATIM. Do NOT use placeholders like 'JOB_1' or '#1'. For STEP 1 supply ONE of job_id (preferred — server fetches the JD from Mongo) OR job_description, plus the candidate's resume via resume_text / resume_content / resume_data. For general 'improve my resume' (no specific job), do NOT call this tool — call resume_tool action=improve instead. Note: the tailored resume is written by your AI client's own model — the assistant you are already using — so it works out of the box with nothing to configure; Workopia runs no LLM of its own and never charges for the AI.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"job_id":{"type":"string","description":"ID of a job from a prior search/refine result. Use the **Job Id** value from the prior search result's content text VERBATIM. Server fetches full JD from Mongo."},"job_description":{"type":"string","description":"Full JD text when the user pastes it directly (alternative to job_id)."},"job_title":{"type":"string"},"company":{"type":"string"},"resume_text":{"type":"string","description":"User's resume content (plain text or JSON Resume as string). Fallback when resume_data is not provided."},"resume_content":{"type":"string"},"resume_data":{"type":"object","description":"PREFERRED shape — structured resume per utils/tailor/types.ts ResumeTree. Server, widget, and main-site PDF template all consume this exact shape. Collect these fields from the user before calling when possible.","properties":{"profile":{"type":"object","properties":{"name":{"type":"string"},"title":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"location":{"type":"string"}},"additionalProperties":true},"summary":{"type":"string"},"experience":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"company":{"type":"string"},"location":{"type":"string"},"startDate":{"type":"string"},"endDate":{"type":"string"},"bullets":{"type":"array","items":{"type":"string"}},"description":{"type":"string"}},"additionalProperties":true}},"education":{"type":"array","items":{"type":"object","properties":{"degree":{"type":"string"},"institution":{"type":"string"},"location":{"type":"string"},"startDate":{"type":"string"},"endDate":{"type":"string"},"bullets":{"type":"array","items":{"type":"string"}},"description":{"type":"string"}},"additionalProperties":true}},"skills":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"string"}},"personalHighlights":{"type":"array","items":{"type":"string"}},"linkedin":{"type":"string"}},"additionalProperties":true},"user_profile":{"type":"object","description":"Optional main-site profile object; used as a fallback source for name/title/contact/experience when resume_data and resume_text are both absent.","additionalProperties":true},"user_email":{"type":"string"},"session_id":{"type":"string"},"customization_level":{"type":"string","enum":["light","moderate","heavy"]},"action":{"type":"string","enum":["prepare","save"],"description":"Omit or 'prepare' = STEP 1 (server returns JD + resume + instructions for you to tailor). 'save' = STEP 2 (pass tailored_resume; server renders a PDF and saves it to the dashboard; requires sign-in)."},"tailored_resume":{"type":"object","description":"STEP 2 only: the tailored resume you generated, as a JSON Resume object (or a JSON string). The server renders it to PDF and stores it on profile.applications[job_id].resumeTailor.","additionalProperties":true},"tailor_resume":{"type":"object","description":"Optional wrapper containing the same fields above (legacy shape).","additionalProperties":true},"parameters":{"type":"object","additionalProperties":true}},"additionalProperties":true}}],"scan":{"score":77,"grade":"B","scanned_at":"2026-09-27T05:27:38.264Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-27T05:27:38.261Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 282ms"]},"poisoning":{"score":13,"max":15,"notes":["5 tool descriptions checked"]},"auth":{"score":3,"max":15,"notes":["open endpoint exposes 1 write-action tools with no auth"]},"maintenance":{"score":15,"max":15,"notes":["last push 27 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[{"id":"auth.open-write","severity":"high","component":"auth","title":"Write-action tools reachable without authentication"},{"id":"poison.long-description","severity":"low","component":"poisoning","title":"Unusually long tool description (over 2,000 characters)","evidence":"tool job_tool: …Search jobs across 90+ countries by title, location, salary, remote/hybrid work mode, or employment type. Find roles in tech, finance, product, design, marketing, and every other vertical — aggregated from 1000+ ATS sources globally. Default action is search; use refine when the user asks for more matches or gives feedback on a prior result set; use save to bookmark a job for the signed-in user (requires OAuth). REFINE PROTOCOL (action=refine has THREE distinct modes): (1) Pure continuation / 'show me more' / 'next batch' / 'another set' / 'more like these': pass refine_recommendations.exclude_ids = the full array of **Job Id** values from the most recent search/refine result's content text (verbatim) + refine_recommendations.session_id = prior response's session_id if present. Server returns next 10 unique jobs. (2) 'Show me more like #N' / 'similar to the Atlassian one' / 'jobs like #2': pass refine_recommendations.liked_indexes = [N] (1-based position from prior numbered list) + exclude_ids + session_id. Equivalently you may pass refine_recommendations.liked_job_ids = [<that job's **Job Id** value verbatim>]. Server seeds the recommendation from that job's title/skills/company profile. (3) 'Less like #N' / 'no more N-style jobs' / 'avoid jobs like that': pass refine_recommendations.disliked_indexes = [N] (or disliked_job_ids = [<Job Id>]) + exclude_ids + session_id. Server suppresses similar jobs. All three modes: if you skip exclude_ids, the user sees duplicates — that's a failure. The handler layers exclude_ids with server-side AgentKit memory, so partial lists still work. NEVER invent 'JOB_1' / '#1' as job_id values — always use the real **Job Id** string from the prior result's content text. For detail requests (user asks about a specific job from the list, e.g. 'details for #1', 'show me this job', 'tell me more about <company>'), DO NOT call this tool — call job_detail_tool instead. That separate tool binds to the job-detail widget card so the full job card renders in chat. OUTPUT BEHAVIOR: Render the search results as a numbered markdown list, one line per job, in this exact compact format: `N. **[Job Title](View_Job_URL)** — Company · Location · Job Type · Compensation · Posted MMM DD`. Embed the View Job URL as a markdown link on the title (so the user can click to apply). Keep URLs intact — don't strip parameters. Skip a field entirely if it's missing — never print 'N/A' placeholders. The numbered list IS the canonical user-facing answer. REQUIRED follow-up: after the list, output EXACTLY these two sentences as two parallel questions (same pattern for action=search and action=refine): Sentence 1 — 'Would you like to see full details on any of these? Reply with the number (#1), the company name, or the role title.' Sentence 2 — 'Or would you like to refine the list — what should change (work mode, level, salary, sector)?' These two sentences must be separate and parallel; do NOT merge them into one 'detail ... or refine' clause (that buries the detail CTA). Both questions must be asked every time after a search or refine result. When the user replies referring to a specific job from the list, identify which job they mean and call job_detail_tool immediately. Identifying the job (use flexibly — users rarely type '#N' literally): (a) any numeric or ordinal reference ('#1', '1', 'first', 'the 1st', 'top one', 'job 3', 'the third') → the Nth job in your prior numbered list; (b) a company name, partial or full ('Morgan Stanley', 'Morstan', 'Capital One') → case-insensitive substring match on the Company field of the prior list, pick the first match; (c) a role/title phrase ('the analyst role', 'the credit risk one') → case-insensitive substring match on the Job Title field. If multiple jobs match, prefer the earliest. Only if no reasonable match exists, ask a one-line clarifying question. Then pass that job's **Job Id** value from the prior search result's content text VERBATIM as job_id to job_detail_tool / tailor_resume_tool / cover_letter_tool. Do NOT invent a placeholder like 'JOB_1' or '#1' — those are not server-valid IDs. For save, pass job_id + optional job_title/company/job_url in save_job. Put search fields in search_jobs or parameters; refine in refine_recommendations; save in save_job.…"}],"inputs":{"probes":[{"url":"https://workopia.io/api/mcp-jobs","reachable":true,"authRequired":false,"latencyMs":282,"serverInfo":{"name":"Workopia","version":"2.0.0"}}],"packages":[],"repo":{"found":true,"owner":"workopia","repo":"workopia-mcp","archived":false,"pushedAt":"2026-08-31T05:28:13Z","stars":316,"forks":21,"openIssues":2,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/274442392?v=4","ownerCreatedAt":"2026-04-08T07:38:52Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/274442392?v=4&s=128","source":"github"},"presence":{"stars":316,"forks":21,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-08-31T05:28:13.000Z","score":44}}}},"grade_history":[],"reviews":[]}