The Workopia MCP server provides tools for job searching, resume management, cover letter generation, and career planning — powered by your own AI client.
Search for jobs (job_tool): Search millions of live job listings across 90+ countries from employer career pages and ATS feeds. Filter by location, job title, company, work mode, employment type, and more. Optionally pass your resume or profile for closer matching.
Refine job results (job_tool with action=refine): Refine prior search results based on feedback or preferences.
Get job details (job_tool with action=detail): Retrieve full details for a specific listing — salary, requirements, skills, and company info.
Tailor your resume (resume_tool with action=tailor): Optimize or rewrite your resume content to better match a specific job description.
Generate a formatted resume (resume_tool with action=generate): Create a styled, formatted, or downloadable PDF resume using various templates (e.g. workopia_classic, workopia_modern). Accepts plain text or JSON Resume format; returns a preview URL and PDF download URL.
Draft cover letters (cover_letter_tool): Generate a cover letter tailored to a specific role.
View your dashboard (dashboard_tool): Access your Workopia dashboard to see saved, tailored, and applied jobs, plus your latest resume.
Career transition planning (career_tool): Get career advice based on your current role, years of experience, skills, industry, and location.
Listed on the MCP Registry (io.github.Shuangshuang007/workopia), providing discoverability and distribution through GitHub's MCP ecosystem.
Integrates with Greenhouse ATS feeds to provide job search capabilities, allowing users to access millions of jobs sourced directly from employer career pages and Greenhouse systems.
Available as an npm package (@shuang_workopia/workopia-mcp) for distribution and installation, making the MCP server accessible through the npm ecosystem.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
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.
https://workopia.io/api/mcp-jobsTransport: Streamable HTTP
Auth: OAuth 2.0 (Dynamic Client Registration + PKCE; handled automatically by the client)
Website: https://workopia.io
Related MCP server: JobGPT MCP Server
/plugin marketplace add workopia/workopia-mcp
/plugin install workopia-jobsOn first tool use, Claude Code opens the Workopia OAuth flow in your browser; the token is then stored and refreshed automatically.
There is no separate GitHub-repository account and no API key to create. The first time an MCP client calls a Workopia tool, it opens the Workopia authorization page in your browser. Sign in with an email code, Google, LinkedIn, or GitHub.
If that verified email already has a Workopia profile, the MCP connection uses it.
Otherwise Workopia creates a minimal profile for that verified email.
The MCP client stores and refreshes its OAuth token. Disconnect or remove Workopia in the client to revoke its local connection.
Using the same verified email from another supported client connects activity to the same Workopia profile; it does not create a separate MCP-only account.
OAuth uses Authorization Code + PKCE and Dynamic Client Registration. Never paste a Workopia password, email code, OAuth token, or resume into this repository or a GitHub issue.
Tool | What it does |
| Search millions of live jobs across 90+ countries (employer career pages + ATS feeds — Lever, Greenhouse, Workday). Save a job to your account (sign-in). |
| Full detail for a single job — salary, requirements, skills, company. |
| Tailor your resume to a specific job description. |
| Draft a cover letter for a specific role. |
| Open your Workopia dashboard — saved, tailored & applied jobs + latest resume (sign-in). |
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.
MCP Registry: io.github.Shuangshuang007/workopia
OpenClaw ClawHub: Shuangshuang007/workopia
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.
Authenticated tool actions such as job searches, job views, saved jobs, applications, resume operations, and cover-letter creation may be associated with your Workopia profile so your dashboard and history work across supported MCP clients. Workopia records the integration family (for example MCP) and, when the OAuth client identifies itself, the client type (for example Codex, Claude Code, Cursor, or Windsurf).
Conversation transcripts are not collected by this MCP server. Activity records do not contain OAuth tokens or raw resume text. Resume content needed for a requested resume operation is handled under the Workopia privacy policy linked below.
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.
Built by HERAAI PTY LLC. Privacy policy: https://workopia.io/privacy
Career transition / planning — same as career_transition_advice. Pass fields in career_transition_advice or career or top-level.
Inputs: career_transition_advice, career.
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 Hera job results or explicit user feedback. Use detail only with a specific job_id. Put search fields in search_jobs or parameters; refine in refine_recommendations; detail in get_job_detail.
Inputs: action, search_jobs, refine_recommendations, get_job_detail, +1 more.
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 resume, downloadable resume, PDF resume, or preview/shareable resume — do NOT use tailor for those. INPUT for generate: resume_text or resume_content (plain text or JSON Resume as string), and/or json_resume (JSON Resume object: basics, work[], education[], skills[] per jsonresume.org — preferred for structured data). At least one of those is required. Optional template_key (Workopia registry key; omit defaults to Workopia Classic / workopia_classic). Legacy alias hera_classic accepted. OUTPUT for generate: template_name, url (preview), download_url (PDF) from the tool only — never invent URLs; never return raw PDF/HTML/base64. OUTPUT for tailor differs (e.g. optimizedResume text).
Inputs: action, template_key, template_keys, session_id, +4 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 3 tools
The three tools cover distinct domains: career planning, job search, and resume actions. Some minor overlap possible between career_tool and resume_tool, but descriptions clearly separate them.
All tool names follow a consistent pattern of lowercase words joined by underscores, ending with '_tool'. This is predictable and uniform.
With only 3 tools, the server covers a broad domain. While each tool encapsulates multiple actions, the count feels slightly low for the range of functionality implied.
Core features like career advice, job search, and resume creation are present. Missing common features like cover letters or application tracking suggest notable gaps.
Public MCP server for discovering open jobs. Search, filter, and get application links.
GetJobzi MCP server for job search, application tracking, and career forecasting.
JobsPipe — data pipeline of every job posting on the web. Search live, normalized job postings from 30+ ATS feeds and job boards for AI agents via MCP.
Free live multi-ATS + HN job search. Comp & hiring-signal depth metered via x402/USDC. Hosted MCP.
