FoundRole MCP
About
Run Your Job Search From Your AI Assistant
Details
- Author
- foundrole
- Categories
- Productivity, Web Scraping, AI
Jump to
Setup
Install FoundRole MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/foundrole/jobs-mcp-proxy
Follow the installation instructions in the repository README, then restart your MCP client.
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 toFoundRole's live job board, application tracker, and career knowledge base, so the whole job search runs inside the chat you already use.
- 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.
It's the same account and data asFoundRole.com— the MCP server just lets your AI drive it.
Search, the fact-checks on every posting, the tracker, reminders, and alerts are free with no usage limits. Pro adds screening: ask for remote-only, sponsors-only, a salary floor, risky postings hidden, or a minimum match, and your assistant filters the list before you ever see it — and tells you when it has. A free account still gets the full list back, with a note that those filters were not applied.
New here?TheFoundRole AI Search guidewalks through connecting each client step by step, with an FAQ.
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.
Point your client at the FoundRole MCP endpoint:
Most modern clients — ChatGPT, Claude, Cursor, VS Code — speak remote MCP (Streamable HTTP) natively, so this is all the configuration there is.
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:
- Open FoundRole in theChatGPT app directory.
- ClickAddand approve the FoundRole sign-in when ChatGPT opens it.
- Ask for jobs in any chat — no settings to configure, nothing to paste.
-
Open Claude settings (profile / settings icon).
FindConnectors(orTools) and clickAdd custom connector.
In theRemote MCP server URLfield, paste:
Save, allow Claude to connect, and approve the FoundRole sign-in it opens. Then ask for jobs in the chat.
In Cursor, open Settings → MCP and add this to~/.cursor/mcp.json:
{ "mcpServers": { "foundrole": { "url": "https://www.foundrole.com/mcp" } } }
In VS Code, add this to.vscode/mcp.jsonin your workspace (or your usermcp.json) — VS Code uses a different key and needs an explicit transport type:
{ "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.
Estimated time:~3 minutes |Requires:Node.js + npm
-
Open LM Studio's MCP servers configuration.
{ "mcpServers": { "foundrole": { "command": "npx", "args": ["@foundrole/ai-job-search-mcp@latest"], "env": {} } } }
Confirmfoundroleappears in your MCP servers list, approve the sign-in it opens, and start asking for jobs.
Estimated time:~4 minutes |Requires:Perplexity Pro + Node.js
-
Open Perplexity's MCP configuration.
{ "command": "npx", "args": ["@foundrole/ai-job-search-mcp@latest"], "env": {} }
Save and restart Perplexity, then approve the FoundRole sign-in when it opens.
Perplexity uses stdio MCP transport — Node.js and npm must be installed.
The same address works everywhere: addhttps://www.foundrole.com/mcpas a remote server, or bridge stdio-only clients withnpx @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.
- 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.
- Check your internet connection and that the URL is exactlyhttps://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 (seeenginesinpackage.jsonfor the required version), then retry, or install globally:npm install -g @foundrole/ai-job-search-mcpand runai-job-search-mcp.
- Double-check the URL, complete the sign-in, and restart the AI client — some clients only pick up the connection after a restart.
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
- Live Job Board— browse the listings directly
- 🌐 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
Interact with task, doc, and project data in Dart, an AI-native project management tool
Create notes, search, & think with your Fabric AI workspace
Great Question is an Agentic UX research platform for product builders. Its MCP lets AI agents create studies directly from any AI tool, surface insights, find the right research candidates, and query your entire research repository.
Magica is your all-in-one AI platform, offering 2500+ cutting-edge tools under a single subscription.
Prompt Buddy MCP exposes a public, searchable catalog of reusable AI skills.
Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.
Dynamically search and call tools using UnifAI Network
A dynamic server for managing multi-agent collaboration within tmux sessions, featuring flexible pane configurations and auto-detection.
Provides AI assistants with advanced task management and memory capabilities using local JSON file storage.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
