TOOLS
Your job search, with your AI assistant
Find overlooked remote jobs, compare your CVs, tailor applications and prepare for interviews. Manage daily or weekly email alerts and keep your profile, documents and progress together in your Hidden Jobs account.
Remote MCP URL
https://hiddenjobs.dev/mcp OAuthAccount sign-in
HTTPRemote server
PrivateYour career data
Remote connection
Connect your AI assistant
Add this MCP server to your provider and select OAuth.
Remote server URL
https://hiddenjobs.dev/mcp Sign in and approve the connection to start using Hidden Jobs with your assistant.
Terminal clients
Connect from the command line
Add the server and sign in through your browser.
Claude Code
claude mcp add --transport http hidden-jobs https://hiddenjobs.dev/mcp
claude mcp login hidden-jobsUse /mcp in Claude Code to manage the connection. Earlier versions also use this menu to sign in.
Codex CLI
codex mcp add hidden-jobs --url https://hiddenjobs.dev/mcp
codex mcp login hidden-jobsStart codex and use /mcp to view the connected server and its tools.
Skills
Workflows for your job search
Reusable instructions guide your assistant through each task. For example, ask it to use apply to prepare an application, then review to check it.
Manage email job alertsalerts
Create daily or weekly searches, change filters, and pause or resume the same alerts as your dashboard. A confirmed email is required to create, modify or resume alerts. You can also pause or delete them.
“Create a daily alert for Backend or DevOps roles in Europe matching TypeScript.”Read skill instructions
Build your profilesetup
Import a CV and confirm your experience, preferences and default CV.
“Set up my profile from this CV and save it as Backend English.”Read skill instructions
Complete your profileexpand
Add confirmed achievements, responsibilities and examples.
“Ask me about missing achievements and add my confirmed answers to my profile.”Read skill instructions
Find remote jobssearch
Search your selected sources and check location eligibility. External provider links are free; saved job activity uses Hidden Jobs offers.
“Find remote TypeScript roles open to applicants in Spain.”Read skill instructions
Compare your matchesmatch
Rank offers against a CV, or choose the best saved CV for an offer.
“Compare all my saved CVs against this offer, choose the best match and explain why.”Read skill instructions
Prepare an applicationapply
Tailor a CV and cover letter. Saved application tracking and base CV references use Hidden Jobs offers.
“Use the best matching CV to prepare a tailored CV and cover letter for this offer.”Read skill instructions
Review your documentsreview
Check facts, relevance and unsupported claims before sending.
“Review this application against the offer and my selected CV. Flag unsupported claims.”Read skill instructions
Download a PDFexport
Generate a PDF and check its text and layout limits.
“Export the reviewed CV as a PDF and check its text and layout.”Read skill instructions
Prepare for interviewsinterview
Practise questions and answers from the offer and your experience.
“Prepare me for this interview using the offer and the CV I used.”Read skill instructions
Build a learning planupskill
Turn requirements into exercises and milestones.
“Build a learning plan for the requirements I want to develop, with three hours a week.”Read skill instructions
Track applicationsoutcome
Record confirmed submissions, interviews, outcomes and next steps.
“I submitted this application today. Mark it as applied and save the next step.”Read skill instructions
Review email updatesemail-sync
Use your separately connected email to propose updates for your approval.
“Check my connected email for updates on my applications and show proposed changes for approval.”Read skill instructions
Review your progressreport
Summarize your pipeline, recent activity and next actions.
“Summarize my applications, recent activity and next actions.”Read skill instructions
Save a templateadd-template
Keep document structure and supported PDF layout settings.
“Save this cover-letter structure as a template for future applications.”Read skill instructions
Manage saved datareset
Preview deletion and confirm it in your account.
“Show me how to remove my saved career data so I can review and confirm it in my account.”Read skill instructions
Install the skill directories using your client’s skill support. Connecting the remote server does not install local skills automatically. The same instructions are available as MCP prompts, workflow resources or through get_workflow.
Available tools
Tools for your job search
TOOLS
Jobs and companies
TOOLS
Workflow instructions
TOOLS
Profile
TOOLS
CV library
TOOLS
Documents
TOOLS
Search and evaluations
TOOLS
Applications
TOOLS
Learning
TOOLS
Data controls
For example: get_cv → save_application → save_document → update_application. Export adds render_document, check_document and get_document_download_url. See the complete tool reference for arguments and examples.
Resources & prompts
Instructions, templates and your saved information
Shared resources provide workflow instructions, guides and templates. Private resources give your connected assistant access to your own records.
hiddenjobs://workflows/{name} Workflow instructions, including match, apply, interview and outcome.
hiddenjobs://guides/{name} job-evaluation, document-review, interview and ats-checks.
hiddenjobs://templates/{name} cv, cover-letter and interview text structures.
hiddenjobs://me/profile Your confirmed experience, preferences and default CV.
hiddenjobs://me/cvs/{id} A saved CV and its immutable versions.
hiddenjobs://me/applications/{id} An application, offer snapshot, selected CV and history.
hiddenjobs://me/documents/{id} Saved document text and metadata.
MCP prompts use the same names as the skills and take no arguments. For example, load interview with prompts/get, then describe the role in your conversation. Private record IDs come from the list/get tools. Use get_workflow when your client does not expose prompts or resources. Resources and prompts reference →
CVs & applications
Your career information, kept together
Work from a remote chat or terminal client. Your saved information stays in your Hidden Jobs account.
Multiple CVs, exact versions
Keep named CVs such as Backend English and Manager Spanish, each with immutable versions. Choose one yourself or ask your assistant to compare all your active CVs with an offer and use the best match. It reads their contents, explains the choice and preserves the exact version without changing your default CV.
Upload a CV in Profile, or transfer the original file through your client’s supported file capability. A chat attachment is available to the remote MCP only when your client can transfer its bytes or provide a supported download reference.
PDF, DOCX and UTF-8 text/Markdown support up to 2 MiB per file and 20 PDF pages. Scanned PDFs need supplied text. Export saved drafts as PDFs and review the final file before sending it.
Prepare, submit and track
Each application keeps an offer snapshot, the selected base CV version, tailored documents, notes and history. A newer CV version does not change an existing application’s selection.
Track saved, preparing, prepared, applied, interview, offer, rejected and withdrawn in Applications. You review and submit on the employer’s website, then confirm the submission to your assistant.
Interview practice uses the offer, anonymous company context and your confirmed experience. email updates require your separately connected email and approval.
Private account data
Your OAuth connection authorizes your assistant to work with your profile, CVs, drafts, evaluations, learning plans and application history. Records belong to your account. Export your saved data or open the account confirmation step to delete it.
Under the hood
Streamable HTTP and JSON-RPC
The endpoint accepts MCP JSON-RPC requests over HTTP POST. Most MCP clients handle the protocol details for you.
Example tools/call messageJSON-RPC
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_jobs",
"arguments": {
"sources": ["hiddenjobs", "jobicy", "weworkremotely", "remoteok", "himalayas"],
"query": "typescript",
"remoteLocation": "EUROPE",
"limit": 10
}
}
}Troubleshooting
Errors
Tool errors include a readable message and the underlying API status in structured content. A multi-source search can succeed partially: inspect sourceResults for individual provider errors and continuation cursors.
StatusMeaningWhat to do
401Account access is missing, expired or revoked.Reconnect your Hidden Jobs account.402Account action is required to continue.Follow the account settings link returned by the tool.409A record changed or an operation conflicts with saved references.Read the latest record and resolve the conflict before retrying.429The account’s request limit was reached.Wait before retrying.Need the raw API?
Use REST directly.
For server-to-server integrations, browse the complete endpoint reference and OpenAPI schema.