JobHunt connect
Connect your AI assistant to JobHunt, a job search workspace: saved jobs, tasks, interviews,documents and your Hunt Page. This repository holds only connection docs, config snippets and registry metadata.It contains no server code. JobHunt's server is not open source; the jobhunt command line is.
Connection address: https://jobhunt.app/mcp (streamable HTTP, sign-in in your browser through OAuth).
How sign-in works
Add the address to your assistant. The first time it uses JobHunt, your browser opens JobHunt's approval screen, which lists whatthe assistant may do. You approve it there; no password, API key or token is typed into the assistant or stored in a file. You cansee and disconnect every connected assistant in JobHunt under Settings. Assistants that cannot open a browser can use an API keywith Authorization: Bearer <key>; create one in JobHunt and keep it out of any file you share.
Add it to your tools
| Product | How | Status |
|---|---|---|
| Codex CLI | snippets/codex.config.toml, then codex mcp login jobhunt |
Verified 2026-11-19 (0.170.0): signed in, 39 tools listed, read, save and delete calls worked |
| Claude Code | claude mcp add --scope project --transport http jobhunt https://jobhunt.app/mcp, then /mcp and Authenticate (snippets/claude-code.mcp.json) |
Verified 2026-11-19 (2.1.328): signed in, 39 tools listed, read, save and delete calls worked |
| GitHub Copilot CLI | copilot mcp add --transport http jobhunt https://jobhunt.app/mcp, then /mcp, jobhunt, Authenticate inside the CLI (snippets/copilot-cli.mcp-config.json) |
Verified 2026-11-19 (1.0.114): signed in, 39 tools listed, read, save and delete calls worked |
| Cline | cline mcp add jobhunt https://jobhunt.app/mcp --transport http --yes, then cline mcp, Authorize OAuth, jobhunt (snippets/cline.mcp.json is the settings-file form; llms-install.md is the short guide for Cline itself) |
Tested 2026-11-20 and 2026-11-22 (Cline CLI 3.0.74) against a test copy of JobHunt: signed in with Authorize OAuth, tools listed, read, save and delete calls worked. On 2026-11-22 a fresh Cline was given only README.md and llms-install.md: it wrote the settings file at the path the CLI reads, and the sign-in and calls then worked (one model could not finish because of Cline's patch tool; another first wrote the file to the wrong place, which llms-install.md now rules out). This is the command line, not the Cline extension for VS Code; starting a task does not begin the sign-in, so run the authorize step first |
| Hugging Face tiny-agents | The folder tiny-agents/jobhunt (agent.json and PROMPT.md). tiny-agents cannot sign in to a remote server itself, so the agent runs the jobhunt command: first npx -y [email protected] auth login --scopes read:profile,read:applications,write:applications,read:tasks,write:tasks,read:contacts,read:documents,read:interviews,read:campaigns,read:companies,read:analytics, then tiny-agents run ./jobhunt |
Tested 2026-11-22 (huggingface_hub 2.4.0, jobhunt 0.1.3) against a test copy of JobHunt: 40 tools listed, and read, save and delete calls worked. The model was reached through a test gateway; the model named in agent.json through Hugging Face Inference Providers was not run. Submitted to the tiny-agents dataset on the Hub (pull request 20), not merged yet: until the maintainers merge it, run the local folder; after that, tiny-agents run JobHuntApp/jobhunt |
| Cursor CLI | snippets/cursor.mcp.json as .cursor/mcp.json, then cursor-agent mcp login jobhunt |
Verified to the level "connected, tools listed (39)" on 2026-11-19 (2026.11.19-f005e9d); tool calls not tested |
| OpenCode | opencode mcp add jobhunt --url https://jobhunt.app/mcp, then opencode mcp auth jobhunt (snippets/opencode.json) |
Live; second sign-in fixed in the release that contains JobHunt#1327. Tested to "connected, tools listed (39)" on 2026-11-19 (2.3.2) against a test copy of JobHunt; tool calls not tested. Until that release is out, if a second sign-in fails with invalid_request, run opencode mcp logout jobhunt first |
| Hermes Agent | snippets/hermes.config.yaml after installing hermes-agent[mcp]==0.19.0 (the plain package lacks the extra), then hermes mcp login jobhunt in a terminal |
Tested 2026-11-19 (0.19.0) against a test copy of JobHunt: signed in, 39 tools listed, read and write calls worked. Hermes has no command for calling a tool, so those calls went through the MCP SDK with Hermes's saved sign-in |
| OpenClaw | openclaw mcp set jobhunt '{"url":"https://jobhunt.app/mcp","transport":"streamable-http","auth":"oauth"}' (snippets/openclaw.mcp-server.json), then openclaw mcp login jobhunt and openclaw mcp status |
Tested to "connected, tools listed (39)" on 2026-11-19 (2026.11.6) against a test copy of JobHunt; tool calls not tested |
| Cursor directory and other plugin catalogs | The root plugin.json and .mcp.json (the Agent Plugins layout), and .cursor-plugin/plugin.json for Cursor's plugin template. Submit this repository's address to the catalog |
Both manifests were checked against the published Agent Plugins schemas; not tested in Cursor's editor or in any catalog |
| Cursor (editor install link) | Install in Cursor | Untested |
| VS Code | Install in VS Code or the snippet below | Untested |
| Kiro | Add to Kiro | Untested |
| Claude (web) | Settings, Connectors, add a custom connector, address https://jobhunt.app/mcp |
Untested here |
| Gemini CLI | gemini mcp add --transport http jobhunt https://jobhunt.app/mcp |
Untested |
| Zed | snippet below | Untested |
| LM Studio | mcp.json snippet below |
Untested |
What "verified" means here. The verified rows (and OpenCode) were tried on 2026-11-19 against a local test copy of JobHunt, notagainst jobhunt.app; the snippets use the production address https://jobhunt.app/mcp. Each row says how far the test went andnothing more. Every other row is untested in its product. Install links decode to a remote-URL config only({"url":"https://jobhunt.app/mcp"}); check that before you accept one. See snippets/ for copyable files.
The tools
JobHunt offers 40 tools. Reads change nothing. Anything that changes your account is a separate tool that the assistantcalls only when you ask, and nothing here contacts an employer or submits an application for you.
| Tool | Does | What |
|---|---|---|
add_note |
changes | Save a note about a job, a contact or a company, or record a conversation the person says they had with a contact (kind conversation, with occurred_on and channel). |
complete_task |
changes | Mark a task done, reopen it, or skip one date of a repeating task. |
configure_pipeline |
changes | Read or change how the pipeline is set up: add, rename, reorder or remove stages, and rename, reorder or remove a stage's checklist templates. |
create_resume |
changes | Create a new main resume from career facts the person stated or confirmed in this conversation. |
delete_record |
changes | Permanently delete one record; this cannot be undone from chat. |
edit_document |
changes | Change one saved document: replace one section, rename it, or reorder and hide sections. |
export_files |
changes | Prepare files to download and check on them: one document as PDF or Word, or one job's selected resume and cover letter as PDFs frozen exactly as they are now, so the person submits what they reviewed. |
get_activity |
reads | Read the dated history of the search, newest first: jobs saved, stage changes, notes, tasks, reported submissions and document changes, for the whole account or one job ("what did I do last week", "when did this job move"). |
get_document |
reads | Read one document in full, section by section. |
get_hunt_page |
reads | Read the person's public Hunt Page setup: its address, whether it is public or private right now, which resume it shows, and which resumes could be shown. |
get_job |
reads | Read one saved job: title, company, stage, link, posting text, the stage moves allowed (stage_type null: that stage no longer exists, or the stages could not be read), and when it entered the stage and last changed. |
get_operation_status |
reads | Check what happened to an earlier change when its response was lost, timed out, or said it was still running. |
get_overview |
reads | Read where the person's job search stands, in one call: today in their time zone, the current Hunt, every stage with its job count, tasks overdue or due in 7 days, interviews in the next 7 days, Applied and offer jobs with days in stage and any later event, links being read, and when free access ends. |
get_profile |
reads | Read the person's account name and email and their Hunt Profiles: the name, email, phone, location and links printed on resumes, cover letters and the Hunt Page. |
import_resume |
changes | Turn the person's existing resume into career facts for review, then save the facts they approve as a new resume. |
list_contacts |
reads | List the people saved in the person's network, or read one in full: details, company, linked jobs, recorded conversations and notes. |
list_documents |
reads | List saved resumes, cover letters and other documents: main resumes, the copies tailored to specific jobs, and which resume is the default. |
list_highlights |
reads | List entries in the person's career journal: dated accomplishments with their role, category and any linked company, newest first. |
list_hunts |
reads | List the person's Hunts: separate job searches, for example one per kind of role, each with its status and how many jobs it holds, and their saved Bookmarks. |
list_interviews |
reads | List interview rounds across all jobs or for one job, soonest first, with date, format, location, status and notes. |
list_jobs |
reads | List saved jobs, optionally only one stage or those matching some words ("what's waiting for me to apply to"). |
list_sharing |
reads | See what is shared now: every document link, job-documents link and the Hunt Page if it is public, with each link, who can open it and when it was shared. |
list_tasks |
reads | List follow-ups and other tasks: by default every open task, soonest first, with overdue ones marked. |
preview_document |
reads | Show the person the pages of one saved document as they will print: a resume, any letter, references or a statement. |
record_submission |
changes | Record that the person has already submitted an application themselves, and move the job to Applied. |
save_contact |
changes | Add a person to the network, or correct one. |
save_cover_letter |
changes | Save a cover letter you drafted for one saved job, alongside that job's copy of the resume. |
save_highlight |
changes | Add or edit a career journal entry from something the person tells you they did. |
save_hunt |
changes | Create a Hunt, or change one: rename it, pause or resume it, change its criteria, or make it the current Hunt that new jobs are saved into. |
save_interview |
changes | Add an interview round to a job, or change one: when it is, how long, format, location, notes, and whether it was completed or skipped. |
save_job |
changes | Save a job the person wants to track. |
save_task |
changes | Create a follow-up or reminder, or change an existing one's title, due date or notes. |
search |
reads | Find saved jobs, documents, contacts, companies, tasks, Hunts and highlights by name, company, title, a job's link or a highlight's text, when the person names something ("the Northwind job") and you do not hold its id. |
send_support_message |
changes | Send the JobHunt team a note from the person: a bug, idea, question or billing matter. Only when they ask or agree after the assistant offers; answers go to their account email. |
set_hunt_page_visibility |
changes | Publish the Hunt Page or take it down. |
share_document |
changes | Create or revoke the share link for one document or one job's documents. |
tailor_resume_for_job |
changes | Start tailoring a resume to one saved job. |
update_hunt_page |
changes | Change the Hunt Page draft: which resume it shows, its address, and whether search engines may list it. |
update_job |
changes | Change one saved job: move it to another stage by name, or correct its title, company, link or posting text. |
update_profile |
changes | Create a Hunt Profile or change one: contact details, its label, or which is the default. |
Privacy, support, terms
- Privacy: https://jobhunt.app/privacy
- Terms: https://jobhunt.app/terms
- Support: https://jobhunt.app/support
- Developers: https://jobhunt.app/developers
- Security: see SECURITY.md
Licence
MIT, Copyright (c) 2026 JobHunt App, Inc. The licence covers the documents and snippets in this repository, not the JobHunt service.
Not listed yet
This repository is not itself a listing. A directory is named here as "Listed in" only after it has accepted JobHunt.
Listed in: mcpservers.org, accepted on 20 November 2026.