Summary
Connects Claude to Workopia's global job database via streamable HTTP with OAuth 2.0 sign-in. You get five tools: search millions of live jobs from 90+ countries (Lever, Greenhouse, Workday feeds plus employer career pages), pull full job details with salary and requirements, tailor your resume to a specific posting, generate cover letters, and open your application dashboard. Resume tailoring and cover letter generation run on your own AI client's model, so Workopia never charges for inference. Free to use at launch. Install it as a Claude Code plugin or drop the endpoint into your MCP config for Claude Desktop, Cursor, or Windsurf.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
3 tools
resume_toolUse for ALL resume-related actions. action omitted or action=tailor: ONLY when the user wants to improve, optimize, tailor, or rewrite a resume (text optimization). action=generate: MANDATORY when the user asks for generate/create resume, resume template, styled or formatted r...8 params
Use for ALL resume-related actions. action omitted or action=tailor: ONLY when the user wants to improve, optimize, tailor, or rewrite a resume (text optimization). action=generate: MANDATORY when the user asks for generate/create resume, resume template, styled or formatted r...
Parameters* required
actionstringOmitted or "tailor" = improve/optimize/tailor/rewrite content only. "generate" = MANDATORY for PDF, downloadable resume, template, styled/formatted output, create/generate resume, or shareable/preview link — never use tailor for those intents.one of
tailor · generateparametersobjectShortcut: tailor fields at top level (excluding action).
session_idstringOptional; correlates GPT session with synthetic owner email for GridFS access (gpt+session_id@internal.hera).
json_resumeobjectOptional for action=generate. JSON Resume object (https://jsonresume.org/schema/): basics, work, education, skills, etc. Same structure library themes consume. Takes precedence over resume_text when both are sent.
resume_textstringFor tailor: required (resume body). For generate: optional if json_resume or object resume_content is set. Plain text or JSON Resume as a string. Alias: resume_content when string.
template_keystringOptional for action=generate. MUST be one of enum values only. Omit = Workopia Classic. Do NOT invent keys; use workopia_flexbox for tech-heavy layout, workopia_elegant for professional/corporate, workopia_designer for product/designer roles. Unknown keys are ignored server-side with fallback.one of
hera_classic · hera_creative · hera_elegant · hera_european · hera_modern_clean · hera_multilingualtailor_resumeobjectPayload for tailoring (same shape as legacy tailor_resume).
template_keysarrayOptional for action=generate; up to 5 registry template keys to render multiple PDFs in one call.
job_toolDefault: find job listings (search). If action is omitted, the request is treated as search. For closer matching on recent roles, pass resume_text and/or user_profile with search (still action=search); do not use any other tool name for this. Use refine when there are prior He...5 params
Default: find job listings (search). If action is omitted, the request is treated as search. For closer matching on recent roles, pass resume_text and/or user_profile with search (still action=search); do not use any other tool name for this. Use refine when there are prior He...
Parameters* required
actionstringOptional; omitted = search. refine = after results/feedback; detail = requires job_id.one of
search · refine · detailparametersobjectsearch_jobsobjectSearch args: city/location is always required. job_title+city uses indexed snapshot; company+city (optional job_title) uses legacy company+location DB match for non-empty results. Optional workMode, employmentType, workModeStrict, resume_text, user_profile, profile_aware.
get_job_detailobjectjob_id (required for detail), optional user_email
refine_recommendationsobjectcareer_toolCareer transition / planning — same as career_transition_advice. Pass fields in career_transition_advice or career or top-level.2 params
Career transition / planning — same as career_transition_advice. Pass fields in career_transition_advice or career or top-level.
Parameters* required
careerobjectcareer_transition_adviceobjectWorkopia MCP Server
Job search, resume tailoring, cover letters & application tracking — available via the Model Context Protocol for Claude Code, Claude Desktop, Cursor, Windsurf, and other MCP clients.
Note: This is a hosted MCP server. Connect via the public endpoint below and sign in with Workopia (OAuth) — no API key to manage. All tools require a free Workopia sign-in; searching, job detail, resume tailoring, cover letters, and your dashboard are all scoped to your account. Resume tailoring and cover letters run on your own AI client's model — Workopia hosts no LLM and never charges for AI.
Endpoint
https://workopia.io/api/mcp-jobs
- Transport: Streamable HTTP
- Auth: OAuth 2.0 (Dynamic Client Registration + PKCE; handled automatically by the client)
- Website: https://workopia.io
Install as a Claude Code plugin
/plugin marketplace add workopia/workopia-mcp
/plugin install workopia-jobs
On first tool use, Claude Code opens the Workopia OAuth flow in your browser; the token is then stored and refreshed automatically.
Tools
| Tool | What it does |
|---|---|
job_tool | Search millions of live jobs across 90+ countries (employer career pages + ATS feeds — Lever, Greenhouse, Workday). Save a job to your account (sign-in). |
job_detail_tool | Full detail for a single job — salary, requirements, skills, company. |
tailor_resume_tool | Tailor your resume to a specific job description. |
cover_letter_tool | Draft a cover letter for a specific role. |
dashboard_tool | Open your Workopia dashboard — saved, tailored & applied jobs + latest resume (sign-in). |
Quick start (manual config)
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"workopia": {
"type": "streamable-http",
"url": "https://workopia.io/api/mcp-jobs"
}
}
}
Cursor — .cursor/mcp.json:
{
"mcpServers": {
"workopia": { "url": "https://workopia.io/api/mcp-jobs" }
}
}
ChatGPT — search "Workopia" in the ChatGPT App Store.
Also listed on
- MCP Registry:
io.github.Shuangshuang007/workopia - npm:
@shuang_workopia/workopia-mcp - OpenClaw ClawHub:
Shuangshuang007/workopia
Live on Glama
Quota
Free at launch. A free Workopia sign-in (OAuth) is required to use the tools — searching, job detail, resume tailoring, cover letters, and your dashboard. Need a higher quota or a custom arrangement? Email shuang@heraai.one.
Report a bug / request a feature
Found something broken or want a tool improved? Open an issue — this repo is where we track bugs and feedback for the Workopia MCP server and Claude Code plugin. For account, billing, or anything private, email shuang@heraai.one.
About
Built by HERAAI PTY LLC. Privacy policy: https://workopia.io/privacy
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Registryactive
Package@shuang_workopia/workopia-mcp
TransportHTTP
UpdatedApr 15, 2026
