Model Context Protocol

Connect your AI agent to JobCubby

Give Claude, Cursor, or any MCP client secure access to your job search — list, add, and update applications and interviews. No API keys. You stay in control.

Authorize in your browser — nothing to paste, revoke anytime.

Paste it into your agent and it sets itself up.

Copy the endpoint

One URL is all your agent needs. Grab it from the field above.

Add it to your client

Paste it into Claude, Cursor, or any MCP client — snippets below.

Authorize in your browser

A consent screen opens, you pick what to allow, and you're connected.

Set up your client

Pick your tool. Each takes under a minute.

Run one command in your terminal:

claude mcp add --transport http jobcubby https://jobcubby.com/mcp

Then start Claude Code and run /mcp to authorize. A browser window opens for consent.

Claude Desktop's config file only loads local (stdio) servers, so bridge the remote endpoint with mcp-remote. Open Settings → Developer → Edit Config and add JobCubby to claude_desktop_config.json:

{
  "mcpServers": {
    "jobcubby": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://jobcubby.com/mcp"]
    }
  }
}

Save, fully restart Claude Desktop, and approve the browser consent screen. Prefer no config file? On a plan with Connectors, add it under Settings → Connectors → Add custom connector using the endpoint URL instead.

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):

{
  "mcpServers": {
    "jobcubby": {
      "type": "http",
      "url": "https://jobcubby.com/mcp"
    }
  }
}

Open Settings → MCP, toggle JobCubby on, and authorize.

JobCubby speaks standard MCP over Streamable HTTP with OAuth 2.1 (dynamic client registration — no pre-shared secrets). Point any compliant client at:

https://jobcubby.com/mcp

Authorization is auto-discovered from:

· /.well-known/oauth-protected-resource
· /.well-known/oauth-authorization-server

What your agent can do

Thirty-nine tools across your whole job search, grouped by the access scope they need.

read

list_applications Your applications — filter by status, stage ever reached, source, rejection reason, date range or archived.
get_application One application with its key facts, including whether its posting has closed.
list_interviews Interviews needing attention — upcoming + awaiting an outcome — each with its id.
get_interview_prep One interview's prep checklist — what to do before the round, and what's done.
list_resumes Your resumes on file.
get_resume One resume version — file metadata + a download link.
get_profile Your master profile — headline, summary, skills, work history, education, and job-search preferences.
get_insights Funnel + response-rate analytics.
list_notifications Your recent activity feed.
get_share_link Your public share link + privacy settings.
list_contacts People you know at a company — recruiters, hiring managers, referrals.
search_jobs Search fresh job postings in JobCubby's index (salaries annual).
list_matches Your AI-scored job matches, best fit first, with the breakdown.
get_job_stats Hiring stats per language and role, over every week collected — counts, salaries, remote share.
list_saved_searches Your saved job searches — filter state, alerts, and ids.
run_saved_search Run a saved search now and get the postings it matches.

write

create_application Add an application — company, role, and any other field.
update_application Edit any field(s) of an application — incl. attaching a résumé version as its CV.
update_application_status Move an application to a new status — with the rejection reason, or the offer's terms and deadline.
schedule_interview Book an interview for an application.
complete_interview Mark an interview complete, optionally with an outcome.
set_interview_prep_item Tick or untick one item on an interview's prep checklist.
add_event Log a call, email, or note on an application's timeline.
update_profile Edit headline, summary, skills, work history, education.
update_preferences Set job-search preferences — target role, seniority, work modes, salary, locations, job types, industries.
update_share_settings Turn the public link on/off + privacy.
create_resume Add a résumé version, with optional plain-text content (used as AI context; 40 characters minimum to be parseable).
update_resume Rename a résumé version or update its text content (40 characters minimum to be parseable).
upload_resume Attach a file (PDF, DOCX, or TXT) to a version — or create one with a file.
set_default_resume Pick your default resume.
create_contact Save a contact at a company.
update_contact Edit a saved contact's details.
save_posting Save a job-search posting into your tracker as Saved.
create_saved_search Save a search (keywords + filters) to your searches.
update_saved_search Rename a saved search or toggle its alerts.

destructive

delete_application Permanently delete an application.
delete_resume Permanently delete a resume version — deleting the default promotes the newest remaining.
delete_contact Permanently delete a saved contact.
delete_saved_search Permanently delete a saved search.

These can't be undone, and live behind the destructive scope you must explicitly grant.

You stay in control

Connecting an agent never hands over your password or a copyable key.

Browser OAuth

You approve access on a consent screen. No keys to leak.

Scoped access

Grant only read, write, or delete — your choice, per agent.

Full audit log

Every tool call is recorded — see exactly what each agent did.

Revoke anytime

Cut off any agent in one click. Rate-limited to 60 calls/min per agent.

Scope	What it allows
read	Read your applications, interviews, resumes, and contacts
write	Create and update applications, interviews, and contacts
destructive	Delete applications and contacts (permanent)

Questions

Do I need an API key?

No. JobCubby uses OAuth — your client opens a browser window where you approve access. There's nothing to copy, store, or rotate.

My agent won't connect — what do I check?

Make sure the URL is exactly https://jobcubby.com/mcp, that your client supports Streamable HTTP + OAuth, and that you completed the browser consent. Re-run your client's connect step to retry.

How do I change permissions or disconnect?

Open Developer settings. Every connected agent is listed with its scopes and recent activity — revoke one, or all, in a click.

What data can a connected agent see?

Only your own — every tool call runs against your account and nobody else's. Reads are gated by the read scope, changes by write, and deletes by destructive.

Ready to connect?

Copy the endpoint, add it to your client, and authorize. You'll be live in under a minute.

Manage agents

What is MCP?