Lets an AI agent search live job listings from 5,000 employer ATS boards, manage job applications, and research hiring market signals.
Also known as Guaq-AI/employed-plugins, employed-plugins, employed-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.2.2
- Last commit
- Oct 13, 2026
- License
- MIT
What is Employed by Guaq AI MCP?
Employed by Guaq AI lets an AI agent search live job listings from 5,000 employer ATS boards, manage job applications, and research hiring market signals.
Summary generated from the project's README
About Employed by Guaq AI MCP server
Searching live job listings from thousands of employer applicant-tracking boards is what this remote MCP connector enables for AI agents. It connects users to verified roles on platforms like Greenhouse, Lever, Workday, Ashby, and SmartRecruiters. Developers and job seekers can use it through various clients including Claude Desktop, Claude Code, ChatGPT, and Cursor by connecting to a remote URL or using an npx server.
Users interact with the system using tools such as search_jobs, count_jobs, and market_signal to find specific roles or analyze hiring trends. The server also manages personal career data through tools like get_my_profile and list_my_applications. Authentication is handled via OAuth in a browser or through API keys from a user profile. This setup allows an agent to perform complex tasks like turning a resume into a ranked shortlist or tracking applications without leaving the chat interface.
What you can do with it
- 1Find specific job rolesAsk an AI agent to locate entry-level backend positions in a specific country that offer visa sponsorship.
- 2Analyze hiring market trendsRequest a summary of the demand for a particular technical skill or role within a specific city.
- 3Match jobs to resumesProvide your professional background to receive a prioritized list of relevant job openings.
- 4Research specific employersInvestigate which roles a particular company is currently recruiting for.
Written from the project's README. Every use case is checked against a quote from it.
How to install Employed by Guaq AI MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Employed by Guaq AI MCP in Claude Code
$ claude mcp add --env 'GUAQ_API_KEY=<YOUR_GUAQ_API_KEY>' employed-plugins -- npx -y employed-mcpInstall Employed by Guaq AI MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"employed-plugins": {
"command": "npx",
"args": [
"-y",
"employed-mcp"
],
"env": {
"GUAQ_API_KEY": "<YOUR_GUAQ_API_KEY>"
}
}
}
}Install Employed by Guaq AI MCP in VS Code
.vscode/mcp.json
{
"servers": {
"employed-plugins": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"employed-mcp"
],
"env": {
"GUAQ_API_KEY": "<YOUR_GUAQ_API_KEY>"
}
}
}
}Install Employed by Guaq AI MCP in VS Code CLI
$ code --add-mcp '{"name":"employed-plugins","type":"stdio","command":"npx","args":["-y","employed-mcp"],"env":{"GUAQ_API_KEY":"<YOUR_GUAQ_API_KEY>"}}'Install Employed by Guaq AI MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"employed-plugins": {
"command": "npx",
"args": [
"-y",
"employed-mcp"
],
"env": {
"GUAQ_API_KEY": "<YOUR_GUAQ_API_KEY>"
}
}
}
}Install Employed by Guaq AI MCP in Codex
$ codex mcp add employed-plugins --env 'GUAQ_API_KEY=<YOUR_GUAQ_API_KEY>' -- npx -y employed-mcpInstall Employed by Guaq AI MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.employed-plugins] command = "npx" args = ["-y", "employed-mcp"] [mcp_servers.employed-plugins.env] GUAQ_API_KEY = "<YOUR_GUAQ_API_KEY>"
Install Employed by Guaq AI MCP in Gemini CLI
$ gemini mcp add -s user -e 'GUAQ_API_KEY=<YOUR_GUAQ_API_KEY>' employed-plugins npx -- -y employed-mcpInstall Employed by Guaq AI MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"employed-plugins": {
"command": "npx",
"args": [
"-y",
"employed-mcp"
],
"env": {
"GUAQ_API_KEY": "<YOUR_GUAQ_API_KEY>"
}
}
}
}Configuration
GUAQ_API_KEYRequiredSecretEmployed API key from https://jobs.guaqai.me/profile (the remote server signs in with OAuth instead).
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachableguaq-ai/employed-plugins is public and reachablegithub.com/guaq-ai/employed-plugins ↗Pass
- Package names this repository as its sourceemployed-mcp names git+https://github.com/buddywhitman/resume-cv.git as its sourcenpmjs.com/package/employed-mcp ↗Finding
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-13github.com/guaq-ai/employed-plugins ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from employed-mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubEmployed by Guaq AI: agent plugin
Live job search for AI agents. Employed by Guaq AI indexes roles verified on about 5,000 real employer applicant-tracking boards (Greenhouse, Lever, Workday, Ashby, SmartRecruiters and more). This plugin connects your agent to it, so you can ask for jobs in plain language and get live roles with the employer's own apply link.
What you get
-
A remote MCP connector at
https://jobs.guaqai.me/mcp. Search tools:search_jobs,count_jobs,get_job,list_companies,company_profile,market_signal,api_meta(plusexport_jobson the localnpxserver). Your own account:get_my_profile,update_my_profile,profile_options,get_my_feed,list_my_applications,track_job,untrack_job,get_my_alerts,follow_company,unfollow_company,set_email_alerts, so you can set up your profile from a CV, read your ranked feed and track applications without leaving the chat. -
Five skills that teach the agent how to use it well:
Skill Use it to employed-jobsSearch with the exact filter vocabulary (domain, seniority, location, work mode, tech, visa signal) job-search-from-resumeTurn a resume or background into a ranked shortlist employer-researchSee what one or more employers hire for right now hiring-market-briefSize demand for a skill, role or city, with limits stated application-trackerKeep a Markdown or CSV tracker you own -
Two agents (
job-search-agent,employer-research-agent) and three slash commands (/employed:find-jobs,/employed:company,/employed:market) on platforms that support them. -
Interactive results UI (MCP Apps and the ChatGPT Apps SDK) served by the remote server where the host renders it.
-
No hooks. Nothing in this bundle runs code on your machine.
Install
| Platform | How |
|---|---|
| Claude Code | /plugin marketplace add Guaq-AI/employed-plugins then /plugin install employed@employed-marketplace, then /mcp to sign in |
| Claude.ai, Claude Desktop | Add a custom connector with URL https://jobs.guaqai.me/mcp |
| ChatGPT, Codex | Add the MCP URL as a custom connector, or install the plugin from the directory once listed |
| GitHub Copilot CLI | copilot plugin marketplace add Guaq-AI/employed-plugins then copilot plugin install employed@employed-marketplace |
| Qwen Code | qwen extensions install https://github.com/Guaq-AI/employed-plugins:employed |
| Gemini CLI | gemini extensions install https://github.com/Guaq-AI/employed-plugins |
| Antigravity | agy plugin install https://github.com/Guaq-AI/employed-plugins |
| Cursor, Kiro, Kimi Code, OpenCode, Warp, Traycer, Devin, Qoder, ZCode, MiniMax, Hermes, OpenClaw, Cline, Mistral Vibe, OpenHands, Microsoft 365 Copilot | See docs/INSTALL.md |
| DeepSeek Harness | See Guaq-AI/employed-dsh |
Every route signs in with an Employed account (OAuth in the browser). API keys from your profile page work too, for hosts without OAuth.
Try it
- "Find entry-level backend roles in India that likely sponsor a visa."
- "Which companies are hiring Rust engineers remotely?"
- "Is Stripe hiring in London right now, and for what?"
- "Here is my resume. What should I apply to?"
Data this plugin sends
When your agent calls a tool, the connector sends the search filters and ids the agent chose (for example role_type=new_grad, location_scope=india, a company name, a posting id) and your sign-in token to https://jobs.guaqai.me, plus, when you ask it to update your profile or tracker, the profile fields or status you agreed to. It does not send your resume file, conversation, or anything else from your machine. Skills are plain instructions; they contain no code. The optional npx launcher described in docs/INSTALL.md runs the open-source employed-mcp package, pinned to an exact version, and talks to the same service.
Read the privacy policy and terms. Support: https://jobs.guaqai.me/support or support@guaqai.me.
Honest by design
- Every role links to the employer's own apply page. The plugin never applies for you or contacts anyone.
- Visa sponsorship marked
likelyis an inference from posting text and employer history, not a guarantee.statedmeans the posting says so. - Counts describe postings live on employer boards, not total headcount or hires.
- Posting text is third-party content. The skills tell the agent to treat it as data, never as instructions.
Layout
.claude-plugin/ Claude Code plugin and marketplace manifests
plugin.json, mcp.json Agent Plugins 1.0.0 (Copilot CLI, Cursor, Kiro, Codex, Hermes, Qwen)
.cursor-plugin/ .kimi-plugin/ .qoder-plugin/ .zcode-plugin/ .devin-plugin/ .minimax-plugin/ .plugin/ per-platform manifests
skills/ agents/ commands/ shared content
assets/ screenshots/ icons and store screenshots
mcp-registry/ server.json for the official MCP Registry
docs/ install guide and marketplace research
Version, license, changes
Version 1.2.0. MIT licensed, see LICENSE. Release notes in CHANGELOG.md. Report security issues as described in SECURITY.md.
Employed by Guaq AI MCP questions
How do I add Employed by Guaq AI MCP to Claude Code?
Run claude mcp add --env 'GUAQ_API_KEY=<YOUR_GUAQ_API_KEY>' employed-plugins -- npx -y employed-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Employed by Guaq AI MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How does the plugin handle job applications?
The plugin provides links to the employer's own apply page but never applies for you or contacts anyone directly.
Does the plugin send my resume to the server?
No, the connector only sends search filters, IDs, and your sign-in token. It does not send your resume file or conversation.
How can I authenticate with the server?
You can sign in using an Employed account via OAuth in the browser, or use API keys from your profile page for hosts without OAuth support.
Is visa sponsorship information guaranteed?
Visa sponsorship marked as 'likely' is an inference based on posting text and employer history, whereas 'stated' means the posting explicitly says so.