FoundRole Jobs MCP Proxy (Model Context Protocol)

This MCP server connects AI assistants to FoundRole’s live job board, application tracker, and career knowledge base. It enables job searches inside chat tools like ChatGPT, Claude, Cursor, and others, returning fact-checked openings with pay and visa-sponsorship details. It also supports job alerts and an application tracker workflow.

🛠️ Key Features

Live job board integration
Application tracker integration
Career knowledge base integration
Fact-checked job listings
Job alerts
OAuth sign-in flow

🚀 Use Cases

Search for jobs via an AI assistant
Verify whether listings are still real
Filter for actual pay and visa sponsorship
Track applications from within chat

⚡ Developer Benefits

Model Context Protocol (MCP) server/proxy for assistant tooling
Standard OAuth sign-in for access
Integration coverage across jobs, tracking, and career knowledge

⚠️ Limitations

OAuth sign-in is required the first time the AI calls FoundRole

FoundRole MCP Server — AI Job Search in ChatGPT, Claude & Cursor

Ask ChatGPT or Claude for jobs and get real openings back — each one checked for whether it's still real, what it actually pays, and whether the company sponsors visas. The FoundRole MCP server connects your AI assistant to FoundRole's live job board, application tracker, and career knowledge base, so the whole job search runs inside the chat you already use.

Sign in once — your assistant handles it. The first time your AI calls FoundRole it opens a standard OAuth sign-in; approve it once in the browser and that covers everything: search, fact-checks, the tracker, reminders, and alerts. There is no API key to copy or rotate, and the account is free.

Add it in one click: ChatGPT plugin · Claude connector · Cursor · VS Code — or any other MCP client.

What your assistant can do

Search live jobs by asking. Openings straight from company career pages, refreshed hourly across 40+ industries. Natural language maps onto real filters — job title, location, company, salary range, posting date: "remote React jobs in NYC paying over $130k posted this week."
Get every posting fact-checked — free. Before you spend an evening on an application, three questions get answered with the evidence behind each call:
- Is anyone actually hiring? Ghost-posting risk — whether the role has been reposted for months or looks like it's fishing for resumes.
- Am I being underpaid? The pay against what employers in that market really file, so a hidden salary range stops being a guess.
- Would they sponsor me? Whether the company has sponsored visas before, counted year by year from public filings.
See how well you fit. Match scoring against your resume and profile, plus personalized job recommendations ranked by fit.
See what hiring software reads off your resume — free. Ask, and you get back the version of you a parser extracts: job title, years, recognized skills, sections, contact details — plus what it loses on the way. It's the mechanical read, deterministic and repeatable, so the answer doesn't drift between asks. Paste the text into the chat, or check the resume already on your account.
Research before you commit. Dig into companies, industry sectors, and hiring by location to decide where to aim.
Compare roles side by side. "Compare these two" lines up fit, pay, sponsorship, and posting risk at once — so the choice stops being a feeling.
Paste a job from anywhere. LinkedIn, a careers page, a link a friend sent — paste the posting into the chat and it gets the same checks, and can sit in your tracker alongside FoundRole listings. Your assistant reads the text you provide; nothing crawls the site for you.
Stop losing track of applications. Save jobs to your Kanban application tracker and move them through Saved → Applied → Interviewing → Offered by asking, then archive each one with how it ended — hired, rejected, ghosted, or withdrawn. Attach notes, tags, the salary offered, and deadlines. The same board shows up in the web app.
Never miss a follow-up. Set a reminder on any tracked job and get an email with a calendar (.ics) invite for Google Calendar, Outlook, or Apple Calendar.
Let the search come to you. Subscribe a search to recurring email alerts — daily, weekly, or monthly — so new matches land in your inbox. Ask to list, change, or cancel them the same way.
Ask the awkward questions too. Interview prep, salary negotiation, resume tactics, company research — answers grounded in FoundRole's knowledge base, with the sources linked.
See results as real panels, not text walls. In clients that support MCP Apps (ChatGPT among them), search results, job details, and your tracker render as interactive panels right in the chat.

It's the same account and data as FoundRole.com — the MCP server just lets your AI drive it.

Free vs Pro

Search, the fact-checks on every posting, the tracker, reminders, and alerts are free with no usage limits. Screening filters work on every account: ask for remote-only, sponsors-only, a salary floor, risky postings hidden, a minimum match, specific benefits or employers, and your assistant filters the list before you ever see it — and tells you which filters ran. A free account gets the first few jobs that pass those filters, plus a count of how many more do; Pro returns the whole filtered list. Searches without screening filters come back in full on every account.

New here? The FoundRole AI Search guide walks through connecting each client step by step, with an FAQ.

Setup

Two ways to connect, depending on your client. Either way, your client opens a FoundRole sign-in the first time it connects — approve it once and you're set.

Option 1 — Remote server (recommended)

Point your client at the FoundRole MCP endpoint:

code

https://www.foundrole.com/mcp

Most modern clients — ChatGPT, Claude, Cursor, VS Code — speak remote MCP (Streamable HTTP) natively, so this is all the configuration there is. In ChatGPT and Claude you don't even need the address: FoundRole Jobs is listed in their directories (see below).

Option 2 — stdio bridge (for clients without remote MCP)

If your client only supports stdio transport, run this package locally with npx; it bridges stdio to the FoundRole endpoint and handles the OAuth sign-in for you:

bash

npx @foundrole/ai-job-search-mcp

The first start opens FoundRole's sign-in page in your browser. After you approve, the bridge keeps the session in ~/.config/foundrole/mcp-auth.json (readable only by you) and renews it on its own, so later starts connect without asking again. Delete that file to sign out.

Connecting your AI assistant

ChatGPT

Estimated time: ~1 minute

Open FoundRole Jobs in ChatGPT's plugins.
Click Install plugin and approve the FoundRole sign-in when ChatGPT opens it.
Ask for jobs in any chat — no settings to configure, nothing to paste.

Claude

Estimated time: ~1 minute

Open FoundRole Jobs in Claude's connector directory.
Add the connector and approve the FoundRole sign-in Claude opens.
Ask for jobs in any chat — no server address to copy.

Claude Code and Cowork: install the FoundRole Jobs plugin (the page opens once you are signed in to Claude). It adds the same connector plus two skills that walk Claude through a job search and a resume check; the source is in claude-plugin/.

Directory connectors switched off in your workspace? Add a custom connector instead: Settings → Connectors → Add custom connector, name it FoundRole, paste https://www.foundrole.com/mcp, save, and approve the sign-in.

Cursor

Estimated time: ~1 minute

Click the button, confirm Install in Cursor, and approve the FoundRole sign-in it opens. FoundRole Jobs is also listed on Cursor Directory.

The Cursor plugin lives in this repository — .cursor-plugin/plugin.json with the server declared in mcp.json. To load it locally, symlink this repo into ~/.cursor/plugins/local/ and reload the window.

VS Code

Estimated time: ~1 minute

Click the badge, confirm Install in VS Code, approve the FoundRole sign-in, then ask for jobs in Copilot Chat in agent mode.

Manual setup — Cursor / VS Code / Windsurf

In Cursor, open Settings → MCP and add this to ~/.cursor/mcp.json:

json

{
  "mcpServers": {
    "foundrole": {
      "url": "https://www.foundrole.com/mcp"
    }
  }
}

In VS Code, add this to .vscode/mcp.json in your workspace (or your user mcp.json) — VS Code uses a different key and needs an explicit transport type:

json

{
  "servers": {
    "foundrole": {
      "type": "http",
      "url": "https://www.foundrole.com/mcp"
    }
  }
}

Approve the FoundRole sign-in when your editor opens it, then ask for jobs in the chat.

Antigravity (Google)

Estimated time: ~1 minute

Install the plugin straight from this repository:

bash

agy plugin install https://github.com/foundrole/jobs-mcp-proxy

Approve the FoundRole sign-in Antigravity opens, then ask for jobs in the CLI. The plugin declares the server in mcp_config.json; to wire it up by hand instead, add the same entry to ~/.gemini/config/mcp_config.json:

json

{
  "mcpServers": {
    "foundrole": {
      "serverUrl": "https://www.foundrole.com/mcp"
    }
  }
}

Any other MCP client

The same address works everywhere: add https://www.foundrole.com/mcp as a remote server, or bridge stdio-only clients with npx @foundrole/ai-job-search-mcp.

Note: After you approve the sign-in, some clients need a restart (quit and reopen) before the connection goes live.

Try saying

"Find senior backend engineer roles in San Francisco posted this week."
"Which of these is least likely to be a ghost posting?"
"Does Stripe sponsor visas? What does this role really pay?"
"Compare the Stripe and Vercel roles on fit, pay, and sponsorship."
"Here's a posting from LinkedIn — run the same checks on it."
"Recommend jobs that match my resume."
"Save it to my tracker and mark it Applied."
"Remind me to follow up next Tuesday morning."
"What's in my Interviewing column right now?"
"Subscribe me to weekly alerts for remote React jobs."
"How do I answer 'walk me through your resume'?"

Security

OAuth 2.1 with PKCE. You sign in to FoundRole through a standard authorization flow — short-lived tokens, instant revocation, no credentials shared with the AI client, no API key to copy, store, or leak.
HTTPS only, with dynamic client registration and redirect-URI validation.
Streamable HTTP transport (direct), or stdio via this proxy.
It never applies or emails anyone as you.

Troubleshooting

Asked to sign in / "needs authentication":

Expected on first connect — the server authenticates every session. Complete the FoundRole sign-in in the browser window your client opens.
If tools still don't appear afterward, restart the client or reconnect the connector so the authorization is re-sent.

"Connection failed":

Check your internet connection and that the URL is exactly https://www.foundrole.com/mcp.
Confirm your client supports remote HTTP MCP; if not, use the stdio bridge (Option 2).

"Command not found" (stdio clients):

Install Node.js (see engines in package.json for the required version), then retry, or install globally: npm install -g @foundrole/ai-job-search-mcp and run ai-job-search-mcp.

Connector not working:

Double-check the URL, complete the sign-in, and restart the AI client — some clients only pick up the connection after a restart.

Explore the data behind the answers

The same data your assistant reads is browsable on FoundRole:

How It Works — where the openings come from and how each posting gets its ghost, pay, and visa checks
H1B Salary Explorer — certified wages employers filed with the U.S. Department of Labor, charted by sector, industry, location, and role
H1B Sponsor Rankings — top visa-sponsoring companies by median filed wage, browsable by industry, sector, city, and state
Company Directory — open roles, salary data, and visa sponsorship history for any employer
Industry Sectors — who's hiring across 40+ industries
Hiring by Location — openings and wage benchmarks by state and metro
Job Tracker — the Kanban board your assistant manages, in the browser
Resume Checker — upload a resume and see what hiring software reads off it, section by section
Resume Builder — build a version per target role and export PDF, DOCX or TXT free, no watermark
Live Job Board — browse the listings directly

Help

🌐 Website: www.foundrole.com — free AI job search, application tracker, and company research
📖 Setup guide & FAQ: foundrole.com/ai-search-mcp
🐛 Issues: GitHub Issues
💬 Questions: dev@foundrole.com

Connect your AI client, sign in once, and run the whole job search from the chat — search, fact-checks, tracking, reminders, and alerts, free at FoundRole.

Made by the FoundRole team.

job_search_id	string	required	Job search UUID or composite job id ("seo_id--job_search_id") from jobs_search results
frequency	string	optional	Alert frequency: daily, weekly, monthly (defaults to "weekly")

status	string	optional	Filter by status: pending, active, unsubscribed
limit	integer	optional	Number of results to return (default 20, max 50)
offset	integer	optional	Number of results to skip (default 0)

url	string	required	Direct URL of the specific job posting; a company homepage is invalid
company_name	string	required	Company name from the posting
title_name	string	required	Job title from the posting
location_name	string	required	Location text from the posting, including Remote when stated
description	string	required	Complete posting text available in the conversation; a source summary is valid only when no fuller posting text is available
posted_at	string \| null	optional	Posting date as ISO 8601, when the source states it
salary_min_value	number \| null	optional	Salary range minimum, when stated
salary_max_value	number \| null	optional	Salary range maximum, when stated
salary_value	number \| null	optional	Single salary amount, when the posting gives one figure instead of a range
salary_type	string \| null	optional	Salary period: year, month, week, day, hour
salary_currency	string \| null	optional	ISO 4217 salary currency code, when stated
employment_type	array \| null	optional	Employment types: full_time, part_time, contractor, temporary, intern, volunteer, per_diem, other
work_location_type	string \| null	optional	Work arrangement: on_site, remote, hybrid
education_requirements	array \| null	optional	Education requirements: no_requirements, high_school, associate_degree, bachelor_degree, professional_certificate, postgraduate_degree
experience_months	integer \| null	optional	Minimum required experience in months, when stated
client_extraction	object \| null	optional	Evidence-backed facts extracted by the client model from the posting; non-null evidence is a short source excerpt rather than an inference. Fields absent from the source are omitted or null.

location	string	optional	Optional preferred location name or slug
page	integer	optional	Recommendation page number

query	string	optional	The full job title or skill (e.g., "Ruby Developer", NOT just "Ruby")
location	string	optional	Geographic location (e.g., 'Boston, MA')
company	string	optional	The official company name
posted_days_ago	integer	optional	Number of days ago to search for jobs (1-365)
remote	boolean	optional	Advanced filter: only remote-eligible jobs (respects the location/region scope).
h1b_sponsors_only	boolean	optional	Advanced filter: only companies known to sponsor H1B visas.
salary_floor	integer	optional	Advanced filter: minimum annualized salary in USD; a posting qualifies when the midpoint of its pay band reaches the floor. Jobs without salary data are dropped.
hide_low_quality	boolean	optional	Advanced filter: hides postings with a risky ghost grade (D/F); ungraded postings stay.
min_match	integer	optional	Advanced filter: minimum personal FoundRole match score (0-100); needs a resume on the account.
cursor	string	optional	Pagination cursor. Treat as an opaque string. COPY EXACTLY.

tracked_job_id	string	required	The tracked job ID — `trackedJobs[].id` from tracker_list output, distinct from `trackable.id` and `job.id` (required)
remind_at	string	required	ISO 8601 datetime, e.g. "2025-03-15T10:00:00Z" (must be in the future)

job_id	string	required	The job ID from jobs.search results
status	string	optional	Initial tracking status: saved, applied, interviewing, offered, archived
sub_status	string	optional	Sub-status within the main status, valid only for that status — saved: interested, researching_company, preparing_application, ready_to_apply; applied: application_submitted, followed_up; interviewing: interview_scheduled, phone_screen, technical, onsite, final_round, pending_feedback; offered: negotiating, considering, offer_received, accepted; archived: ghosted, rejected_by_company, withdrawn_by_candidate, not_interested, employed_by_this_company, employed_by_another_company
notes	string	optional	Notes about this job

FoundRole Jobs MCP Proxy (Model Context Protocol)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

job_alert_disable

job_alert_enable

job_alert_list

job_alert_unsubscribe_all

jobs_analyze_external

jobs_compare

jobs_details

jobs_recommendations

jobs_search

knowledge_search

knowledge_topics

reminder_delete

reminder_list

reminder_set

tracker_list

tracker_remove

tracker_save_external

tracker_save

tracker_update_status

tracker_update

FoundRole MCP Server — AI Job Search in ChatGPT, Claude & Cursor

What your assistant can do

Free vs Pro

Setup

Option 1 — Remote server (recommended)

Option 2 — stdio bridge (for clients without remote MCP)

Connecting your AI assistant

ChatGPT

Claude

Cursor

VS Code

Manual setup — Cursor / VS Code / Windsurf

Antigravity (Google)

Any other MCP client

Try saying

Security

Troubleshooting

Explore the data behind the answers

Help

Install

Related servers