JobGPT MCP Server
The official MCP server for JobGPT — search jobs, auto-apply, manage resumes, and track applications directly from Claude, Cursor, Windsurf, and any MCP-compatible AI tool.
What You Can Do
Ask your AI assistant things like:
"Find remote senior React jobs paying over $150k"
"Auto-apply to the top 5 matches from my job hunt"
"Generate a tailored resume for this Google application"
"Show my application stats for the last 7 days"
"Find recruiters for this job and draft an outreach email"
The MCP server connects your AI assistant to the full JobGPT platform — 34 tools covering job search, applications, resumes, outreach, and more.
Quick Start
1. Get Your API Key
Go to 6figr.com/account
Scroll to MCP Integrations
Click Generate API Key
Copy the key (starts with
mcp_)
2. Add to Your AI Tool
Pick your tool below and paste the config. Replace your-api-key-here with your actual key.
Setup by Client
Claude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"jobgpt": {
"command": "npx",
"args": ["-y", "jobgpt-mcp-server"],
"env": {
"JOBGPT_API_KEY": "your-api-key-here"
}
}
}
}Claude Code (CLI)
Run this in your terminal:
claude mcp add jobgpt -e JOBGPT_API_KEY=your-api-key-here -- npx -y jobgpt-mcp-serverOr add manually to ~/.claude/settings.json:
{
"mcpServers": {
"jobgpt": {
"command": "npx",
"args": ["-y", "jobgpt-mcp-server"],
"env": {
"JOBGPT_API_KEY": "your-api-key-here"
}
}
}
}Cursor
Go to Settings > MCP > Add new MCP server, or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"jobgpt": {
"command": "npx",
"args": ["-y", "jobgpt-mcp-server"],
"env": {
"JOBGPT_API_KEY": "your-api-key-here"
}
}
}
}Windsurf
Go to Settings > Cascade > MCP > Add Server > Add custom server, or add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"jobgpt": {
"command": "npx",
"args": ["-y", "jobgpt-mcp-server"],
"env": {
"JOBGPT_API_KEY": "your-api-key-here"
}
}
}
}Cline (VS Code)
Open the Cline MCP settings in VS Code and add:
{
"mcpServers": {
"jobgpt": {
"command": "npx",
"args": ["-y", "jobgpt-mcp-server"],
"env": {
"JOBGPT_API_KEY": "your-api-key-here"
}
}
}
}Continue (VS Code / JetBrains)
Add to your Continue config (~/.continue/config.yaml):
mcpServers:
- name: jobgpt
command: npx
args: ["-y", "jobgpt-mcp-server"]
env:
JOBGPT_API_KEY: your-api-key-hereRemote (Hosted) Mode
If you prefer not to run the server locally, you can connect to the hosted version using mcp-remote. This requires no local Node.js installation:
{
"mcpServers": {
"jobgpt": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://jobgpt-mcp-server.cto-df7.workers.dev/mcp",
"--header",
"Authorization:Bearer your-api-key-here"
]
}
}
}Available Tools
Job Search
Tool | Description |
| Search jobs with filters — titles, locations, companies, skills, salary, remote, H1B sponsorship |
| Get new job matches from a saved job hunt (only unseen jobs) |
| Get full details of a specific job posting |
Profile & Salary
Tool | Description |
| View your profile — skills, experience, work history, education |
| Update name, headline, location, skills, experience |
| Get your current compensation details |
| Update base salary, stocks, bonus, target salary |
| List supported currencies (for salary updates) |
| Check your remaining credits balance |
Job Hunts
Tool | Description |
| List your saved job hunts with credits balance |
| Create a new job hunt with search filters and auto-apply settings |
| Get details of a specific job hunt |
| Update filters, auto-apply mode, daily limits, status |
Applications
Tool | Description |
| Aggregated stats — counts by status, auto-apply metrics |
| List applications filtered by job hunt or status |
| Get full application details |
| Update status or notes |
| Trigger auto-apply for an application |
| Save a job from search results to your applications |
| Import a job from any URL (LinkedIn, Greenhouse, Lever, Workday, etc.) |
Resume
Tool | Description |
| List your uploaded resumes |
| Get resume details and download URL |
| Delete an alternate resume |
| Upload a resume from URL (PDF, DOC, DOCX) |
| List AI-tailored resumes created for applications |
| Get a generated resume's download URL |
| Generate an AI-optimized resume for a specific application |
| Calculate resume-to-job match score with skill analysis |
Outreach
Tool | Description |
| Find recruiters associated with a job |
| Find potential referrers at a company |
| Get recruiters for a saved application |
| Find referrers for a saved application |
| List your sent outreach emails |
| Send an outreach email to a recruiter or referrer |
Environment Variables
Variable | Required | Default | Description |
| Yes | — | Your API key from 6figr.com/account |
| No |
| API base URL |
| No |
| Enable debug logging to stderr |
Troubleshooting
"JOBGPT_API_KEY environment variable is required"
Your API key isn't being passed to the server. Make sure it's in the env block of your MCP config.
Tool calls failing with "API Error (401)"
Your API key is invalid or expired. Generate a new one at 6figr.com/account.
"You have run out of credits"
Some operations (auto-apply, resume generation) consume credits. Purchase more at 6figr.com/jobgpt.
Server not appearing in your AI tool
Make sure Node.js 18+ is installed (
node --version)Restart your AI tool after editing the config file
Try running manually to check for errors:
JOBGPT_API_KEY=your-key npx jobgpt-mcp-server
Debug mode
Add "DEBUG": "true" to your env config to see detailed API request/response logs in stderr.
Development
git clone https://github.com/6figr-com/jobgpt-mcp-server.git
cd jobgpt-mcp-server
npm install
cp .env.example .env # add your API key
npm run dev:local # run stdio server locally
npm run build # compile TypeScript
npm run dev:worker # run Cloudflare Worker locally
npm run deploy # deploy to Cloudflare WorkersTesting with MCP Inspector
npx @modelcontextprotocol/inspectorLicense
MIT
Links
JobGPT — AI-powered job search platform
Get API Key — Generate your MCP API key
GitHub Issues — Report bugs or request features