About Workopia — Job Search
Workopia is a hosted MCP server that searches over 6.3 million live jobs taken from company career pages, with resume tailoring and cover letter drafting. Users sign in with OAuth, and generation runs on the user's own AI client model.
Key features
- 01Search live jobs from company career pages
- 02View detailed information for a single job
- 03Tailor a resume to a job description
- 04Draft cover letters for specific roles
- 05Dashboard of saved and applied jobs
Use cases
- 01Searching current job openings from Claude Code or Cursor
- 02Tailoring a resume and drafting a cover letter for a target role
- 03Tracking saved and applied jobs across MCP clients
MCP support
This is a remote MCP server that exposes five tools (job_tool, job_detail_tool, tailor_resume_tool, cover_letter_tool, dashboard_tool) over a Streamable HTTP endpoint. MCP clients authenticate with OAuth 2.0.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://workopia.io/api/mcp-jobsclaude mcp add --transport http workopia-workopia https://workopia.io/api/mcp-jobs{"mcpServers":{"workopia-workopia":{"type":"http","url":"https://workopia.io/api/mcp-jobs"}}}Open in Cursor{"servers":{"workopia-workopia":{"type":"http","url":"https://workopia.io/api/mcp-jobs"}}}Open in VS Code{"mcpServers":{"workopia-workopia":{"type":"http","url":"https://workopia.io/api/mcp-jobs"}}}{"mcpServers":{"workopia-workopia":{"serverUrl":"https://workopia.io/api/mcp-jobs"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
5| Parameter | Type | Required | Description |
|---|---|---|---|
| action | enum | No | 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).prepare | save |
| job_id | string | No | 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. |
| company | string | No | |
| job_title | string | No | |
| parameters | object | No | |
| session_id | string | No | |
| user_email | string | No | |
| resume_data | object | No | 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. |
| resume_data.skills | array | No | |
| resume_data.profile | object | No | |
| resume_data.profile.name | string | No | |
| resume_data.profile.email | string | No | |
| resume_data.profile.phone | string | No | |
| resume_data.profile.title | string | No | |
| resume_data.profile.location | string | No | |
| resume_data.summary | string | No | |
| resume_data.linkedin | string | No | |
| resume_data.education | array | No | |
| resume_data.languages | array | No | |
| resume_data.experience | array | No | |
| resume_data.personalHighlights | array | No | |
| resume_text | string | No | User's resume content (plain text or JSON Resume as string). Fallback when resume_data is not provided. |
| user_profile | object | No | Optional main-site profile object; used as a fallback source for name/title/contact/experience when resume_data and resume_text are both absent. |
| tailor_resume | object | No | Optional wrapper containing the same fields above (legacy shape). |
| resume_content | string | No | |
| job_description | string | No | Full JD text when the user pastes it directly (alternative to job_id). |
| tailored_resume | object | No | 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. |
| customization_level | enum | No | light | moderate | heavy |
Details
From the project READMEWorkopia 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.
Sign up and sign in
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.
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 [email protected].
Account activity and privacy
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.
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 [email protected].
About
Built by HERAAI PTY LLC. Privacy policy: https://workopia.io/privacy
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.