{ "markdown": "# JobGPT MCP Server\n\nThe official [MCP server](https://modelcontextprotocol.io) for [JobGPT](https://6figr.com/jobgpt-ai) — auto apply & search jobs, generate and manage custom tailored resumes, and track applications directly from Claude, Cursor, Windsurf, and any MCP-compatible AI tool.\n\n\n \"JobGPT\n\n\n## What You Can Do\n\nAsk your AI assistant things like:\n\n- *\"Find remote senior React jobs paying over $150k\"*\n- *\"Auto-apply to the top 5 matches from my job hunt\"*\n- *\"Generate a tailored resume for this Google application\"*\n- *\"Apply to this job for me - \"*\n- *\"Show my application stats for the last 7 days\"*\n- *\"Find recruiters for this job and draft an outreach email\"*\n\nThe MCP server connects your AI assistant to the full JobGPT platform — 34 tools covering job search, applications, resumes, outreach, and more.\n\n## Quick Start\n\nThere are two ways to connect, depending on your AI tool:\n\n- **Browser login (recommended)** — no API key, no JSON, no Node.js. Just add the server URL and sign in to 6figr in your browser. Works with Claude Desktop, Claude Code, Codex CLI (`codex mcp login`), and ChatGPT Web (Developer Mode).\n- **API key** — for the ChatGPT Desktop app, Cursor, Windsurf, Cline, Continue, and manual config. Paste a key into the tool's config.\n\n### Get an API Key (only for the API-key method)\n\n1. Go to [6figr.com/account](https://6figr.com/account)\n2. Scroll to **MCP Integrations**\n3. Click **Generate API Key**\n4. Copy the key (starts with `sk_`)\n\n> The browser-login method does **not** need this — it fetches your key for you after you sign in.\n\n---\n\n## Setup by Client\n\n### Claude Desktop\n\n**Recommended — browser login (no API key, no JSON):**\n\n1. Open **Settings → Connectors → Add custom connector**\n2. Name it `JobGPT` and enter the URL `https://mcp.6figr.com/mcp`\n3. Click **Connect** — your browser opens a 6figr sign-in page\n4. Sign in and click **Approve**. Done — the JobGPT tools appear in Claude.\n\nNo terminal, no config file, no Node.js. This uses OAuth, so your API key never touches Claude's config — Claude gets a scoped token instead.\n\n**Alternative — API key via `mcp-remote`** (for older Claude Desktop builds that don't show Connectors; requires Node.js 18+):\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"jobgpt\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-remote\",\n \"https://mcp.6figr.com/mcp\",\n \"--header\",\n \"Authorization:${AUTH_HEADER}\"\n ],\n \"env\": {\n \"AUTH_HEADER\": \"Bearer your-api-key-here\"\n }\n }\n }\n}\n```\n\n### Claude Code (CLI)\n\n**Recommended — browser login (no API key):** add the server, then authenticate in your browser:\n\n```bash\nclaude mcp add jobgpt -t http -u https://mcp.6figr.com/mcp\n```\n\nThen run `/mcp` inside Claude Code, select **jobgpt → Connect**, and sign in to 6figr when the browser opens. Claude Code stores a scoped OAuth token — no API key needed.\n\n**Option A: One-liner with an API key** (`claude mcp add`):\n\n```bash\nclaude mcp add jobgpt -t http -u https://mcp.6figr.com/mcp --header \"Authorization: your-api-key-here\"\n```\n\n**Option B: Edit `settings.json` manually**\n\nAdd to `~/.claude/settings.json`:\n\n```json\n{\n \"mcpServers\": {\n \"jobgpt\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.6figr.com/mcp\",\n \"headers\": {\n \"Authorization\": \"your-api-key-here\"\n }\n }\n }\n}\n```\n\n### Codex CLI (ChatGPT)\n\n**Recommended — browser login (no API key):** add the server, then authenticate in your browser:\n\n```bash\ncodex mcp add jobgpt --url https://mcp.6figr.com/mcp\ncodex mcp login jobgpt\n```\n\n`codex mcp login` opens a browser to sign in to 6figr and approve access; Codex stores a scoped OAuth token (OAuth 2.1 + PKCE). No API key needed.\n\n**Alternative — API key via header:**\n\n```bash\ncodex mcp add jobgpt --url https://mcp.6figr.com/mcp --header \"Authorization: Bearer your-api-key-here\"\n```\n\n### ChatGPT\n\nChatGPT connects two different ways depending on where you add the server:\n\n**ChatGPT Desktop app — API key.** Open **Settings → Connectors → Advanced/Developer → Connect to a custom MCP** and fill in:\n\n- **Name:** `JobGPT`\n- **Type:** `Streamable HTTP`\n- **URL:** `https://mcp.6figr.com/mcp`\n- **Headers → Add header:** Key `Authorization`, Value `Bearer your-api-key-here`\n\nThe desktop dialog authenticates by header (there's no browser-login button), so use your `sk_` key here. Leave the env-var fields blank.\n\n**ChatGPT Web (Developer Mode) — browser login (OAuth).** On the web app, enable **Settings → Connectors → Advanced → Developer mode**, then **Add custom connector**, name it `JobGPT`, and enter the URL `https://mcp.6figr.com/mcp`. ChatGPT runs the OAuth flow: sign in to 6figr in the popup and approve. No API key needed. (Developer mode is available on Plus, Pro, Business, Enterprise, and Edu plans.)\n\n### Cursor\n\nGo to **Settings** > **MCP** > **Add new MCP server**, or add to `~/.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"jobgpt\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.6figr.com/mcp\",\n \"headers\": {\n \"Authorization\": \"your-api-key-here\"\n }\n }\n }\n}\n```\n\n### Windsurf\n\nGo to **Settings** > **Cascade** > **MCP** > **Add Server** > **Add custom server**, or add to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"jobgpt\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.6figr.com/mcp\",\n \"headers\": {\n \"Authorization\": \"your-api-key-here\"\n }\n }\n }\n}\n```\n\n### Cline (VS Code)\n\nOpen the Cline MCP settings in VS Code and add:\n\n```json\n{\n \"mcpServers\": {\n \"jobgpt\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.6figr.com/mcp\",\n \"headers\": {\n \"Authorization\": \"your-api-key-here\"\n }\n }\n }\n}\n```\n\n### Continue (VS Code / JetBrains)\n\nAdd to your Continue config (`~/.continue/config.yaml`):\n\n```yaml\nmcpServers:\n - name: jobgpt\n type: http\n url: https://mcp.6figr.com/mcp\n headers:\n Authorization: \"your-api-key-here\"\n```\n\n### Alternative: Run Locally\n\nIf you prefer to run the server on your machine (requires Node.js 18+):\n\n```json\n{\n \"mcpServers\": {\n \"jobgpt\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"jobgpt-mcp-server\"],\n \"env\": {\n \"JOBGPT_API_KEY\": \"your-api-key-here\"\n }\n }\n }\n}\n```\n\n---\n\n## Available Tools\n\n### Job Search\n\n| Tool | Description |\n|------|-------------|\n| `search_jobs` | Search jobs with filters — titles, locations, companies, skills, salary, remote, H1B sponsorship |\n| `match_jobs` | Get new job matches from a saved job hunt (only unseen jobs) |\n| `get_job` | Get full details of a specific job posting |\n\n### Profile & Salary\n\n| Tool | Description |\n|------|-------------|\n| `get_profile` | View your profile — skills, experience, work history, education |\n| `update_profile` | Update name, headline, location, skills, experience |\n| `get_salary` | Get your current compensation details |\n| `update_salary` | Update base salary, stocks, bonus, target salary |\n| `get_currencies` | List supported currencies (for salary updates) |\n| `get_credits` | Check your remaining credits balance |\n\n### Job Hunts\n\n| Tool | Description |\n|------|-------------|\n| `list_job_hunts` | List your saved job hunts with credits balance |\n| `create_job_hunt` | Create a new job hunt with search filters and auto-apply settings |\n| `get_job_hunt` | Get details of a specific job hunt |\n| `update_job_hunt` | Update filters, auto-apply mode, daily limits, status |\n\n### Applications\n\n| Tool | Description |\n|------|-------------|\n| `get_application_stats` | Aggregated stats — counts by status, auto-apply metrics |\n| `list_applications` | List applications filtered by job hunt or status |\n| `get_application` | Get full application details |\n| `update_application` | Update status or notes |\n| `apply_to_job` | Trigger auto-apply for an application |\n| `add_job_to_applications` | Save a job from search results to your applications |\n| `import_job_by_url` | Import a job from any URL (LinkedIn, Greenhouse, Lever, Workday, etc.) |\n\n### Resume\n\n| Tool | Description |\n|------|-------------|\n| `list_resumes` | List your uploaded resumes |\n| `get_resume` | Get resume details and download URL |\n| `delete_resume` | Delete an alternate resume |\n| `upload_resume` | Upload a resume from URL (PDF, DOC, DOCX) |\n| `list_generated_resumes` | List AI-tailored resumes created for applications |\n| `get_generated_resume` | Get a generated resume's download URL |\n| `generate_resume_for_job` | Generate an AI-optimized resume for a specific application |\n| `calculate_match_score` | Calculate resume-to-job match score with skill analysis |\n\n### Outreach\n\n| Tool | Description |\n|------|-------------|\n| `get_job_recruiters` | Find recruiters associated with a job |\n| `get_job_referrers` | Find potential referrers at a company |\n| `get_application_recruiters` | Get recruiters for a saved application |\n| `get_application_referrers` | Find referrers for a saved application |\n| `list_outreaches` | List your sent outreach emails |\n| `send_outreach` | Send an outreach email to a recruiter or referrer |\n\n---\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `JOBGPT_API_KEY` | Yes | — | Your API key from [6figr.com/account](https://6figr.com/account) |\n| `JOBGPT_API_URL` | No | `https://6figr.com` | API base URL |\n| `DEBUG` | No | `false` | Enable debug logging to stderr |\n\n## Troubleshooting\n\n### \"JOBGPT_API_KEY environment variable is required\"\n\nYour API key isn't being passed to the server. Make sure it's in the `env` block of your MCP config.\n\n### Tool calls failing with \"API Error (401)\"\n\nYour API key is invalid or expired. Generate a new one at [6figr.com/account](https://6figr.com/account).\n\n### \"You have run out of credits\"\n\nSome operations (auto-apply, resume generation) consume credits. Purchase more at [6figr.com/jobgpt](https://6figr.com/jobgpt).\n\n### Server not appearing in your AI tool\n\n1. Make sure Node.js 18+ is installed (`node --version`)\n2. Restart your AI tool after editing the config file\n3. Try running manually to check for errors: `JOBGPT_API_KEY=your-key npx jobgpt-mcp-server`\n\n### Debug mode\n\nAdd `\"DEBUG\": \"true\"` to your env config to see detailed API request/response logs in stderr.\n\n## Development\n\n```bash\ngit clone https://github.com/6figr-com/jobgpt-mcp-server.git\ncd jobgpt-mcp-server\nnpm install\ncp .env.example .env # add your API key\n\nnpm run dev:local # run stdio server locally\nnpm run build # compile TypeScript\nnpm run dev:worker # run Cloudflare Worker locally\nnpm run deploy # deploy to Cloudflare Workers\n```\n\n### Testing with MCP Inspector\n\n```bash\nnpx @modelcontextprotocol/inspector\n```\n\n## License\n\nMIT\n\n## Links\n\n- [JobGPT](https://6figr.com/jobgpt-ai) — AI-powered job search platform\n- [Get API Key](https://6figr.com/account) — Generate your MCP API key\n- [GitHub Issues](https://github.com/6figr-com/jobgpt-mcp-server/issues) — Report bugs or request features\n", "bytes": 11403, "sha": "5650de35300b78d6eb79b910b447f3acbdb818d57834c9784c084c2d7b2ba573", "repo_slug": "6figr-com/jobgpt-mcp-server", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_6figr_com_jobgpt_mcp_server_9f042c94/readme" }