{"_id":"@careermax/agent-toolkit","_rev":"4-a07df89cdc9fdbb0237fac1dfcc9ecdc","name":"@careermax/agent-toolkit","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@careermax/agent-toolkit","version":"0.1.0","keywords":["careermax","mcp","cli","ai-agent"],"license":"MIT","_id":"@careermax/agent-toolkit@0.1.0","maintainers":[{"name":"careermax","email":"support@careermax.ai"}],"homepage":"https://careermax.ai","bugs":{"url":"https://github.com/rahulphenomenon/careermax/issues"},"bin":{"careermax":"dist/bin/cli.js","careermax-mcp":"dist/bin/mcp.js"},"dist":{"shasum":"7a0757ce307e8bb088163675bfecf43ea4ea3cbc","tarball":"https://registry.npmjs.org/@careermax/agent-toolkit/-/agent-toolkit-0.1.0.tgz","fileCount":13,"integrity":"sha512-/bh1D1Drmprw/06A7CbtGWr17QuVFxAP0khAlR8/QOvUMRZfmmwVS5Nk4QR7NaxTsdHraPu5wv5WsaZOnXGabA==","signatures":[{"sig":"MEYCIQD9I7qcmLHCsKVZwkLyAuZGg64tzrCqqGeqgI3sh/CHUQIhAIy4rKWhdmejhxwr1TLzhCMzsiu7b5i2qHrSKCLCFndT","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":207183},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"careermax","email":"support@careermax.ai"},"repository":{"url":"git+https://github.com/rahulphenomenon/careermax.git","type":"git","directory":"packages/agent-toolkit"},"_npmVersion":"11.9.0","description":"MCP server and CLI for connecting AI agents to CareerMax","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.0","commander":"^13.1.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","vitest":"^3.1.0","typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-toolkit_0.1.0_1773754055635_0.5467195153194397","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@careermax/agent-toolkit","version":"0.1.1","keywords":["careermax","mcp","cli","ai-agent"],"license":"MIT","_id":"@careermax/agent-toolkit@0.1.1","maintainers":[{"name":"careermax","email":"support@careermax.ai"}],"homepage":"https://careermax.ai","bugs":{"url":"https://github.com/rahulphenomenon/careermax/issues"},"bin":{"careermax":"dist/bin/cli.js","careermax-mcp":"dist/bin/mcp.js"},"dist":{"shasum":"ed6833a37949186d32df20fd5cac16526ce0dfd7","tarball":"https://registry.npmjs.org/@careermax/agent-toolkit/-/agent-toolkit-0.1.1.tgz","fileCount":13,"integrity":"sha512-eK0ojjuHyNcymY2ES0lZymBkwHBezyScns6FzmCUSTKWXTDxkxDMdj2JSXyDAQhImM3uz6RK5CNH8UWnN7mqlA==","signatures":[{"sig":"MEYCIQD9BM170/Ar2up90x1EyFy8xTkIaS7IGidc5xciPujNkgIhAKCjKoENmZ6XoRBS80eOutPrUstFkfKPqEyXjerpsMJK","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":206666},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"careermax","email":"support@careermax.ai"},"repository":{"url":"git+https://github.com/rahulphenomenon/careermax.git","type":"git","directory":"packages/agent-toolkit"},"_npmVersion":"11.9.0","description":"MCP server and CLI for connecting AI agents to CareerMax","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.0","commander":"^13.1.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","vitest":"^3.1.0","typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-toolkit_0.1.1_1773754843276_0.8878970078949289","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@careermax/agent-toolkit","version":"0.1.2","keywords":["careermax","mcp","cli","ai-agent"],"license":"MIT","_id":"@careermax/agent-toolkit@0.1.2","maintainers":[{"name":"careermax","email":"support@careermax.ai"}],"homepage":"https://careermax.ai","bugs":{"url":"https://github.com/rahulphenomenon/careermax/issues"},"bin":{"careermax":"dist/bin/cli.js","careermax-mcp":"dist/bin/mcp.js"},"dist":{"shasum":"68a0699605c006e5e130a504dc2e60819bafad2b","tarball":"https://registry.npmjs.org/@careermax/agent-toolkit/-/agent-toolkit-0.1.2.tgz","fileCount":13,"integrity":"sha512-spC/0+PuIRin+VmekK2WnTPvRMAbw8ai6QaWs42e3nThRyxHGiO3ppChjjVeg2W965/SGmVo6mRYkC19D0a/7g==","signatures":[{"sig":"MEQCICeMzlswlK/HfhZOxeOcB3jmUEp+kA0Lgj3Me4Ft4RrPAiAYzhW5CHYbnl4WmozYjalq2Hivmml85JJex8onOTB9tA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":206718},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","mcpName":"io.github.rahulphenomenon/careermax","scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"careermax","email":"support@careermax.ai"},"repository":{"url":"git+https://github.com/rahulphenomenon/careermax.git","type":"git","directory":"packages/agent-toolkit"},"_npmVersion":"11.9.0","description":"MCP server and CLI for connecting AI agents to CareerMax","directories":{},"_nodeVersion":"25.6.1","dependencies":{"zod":"^3.24.0","commander":"^13.1.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.4.0","vitest":"^3.1.0","typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/agent-toolkit_0.1.2_1773763471406_0.31172271011021424","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@careermax/agent-toolkit","version":"0.1.3","description":"MCP server and CLI for connecting AI agents to CareerMax","type":"module","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"agent-toolkit":"dist/bin/cli.js","careermax":"dist/bin/cli.js","careermax-mcp":"dist/bin/mcp.js"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/rahulphenomenon/careermax.git","directory":"packages/agent-toolkit"},"homepage":"https://careermax.ai","bugs":{"url":"https://github.com/rahulphenomenon/careermax/issues"},"author":{"name":"CareerMax"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","commander":"^13.1.0","zod":"^3.24.0"},"devDependencies":{"tsup":"^8.4.0","typescript":"^5.8.0","vitest":"^3.1.0","@types/node":"^22.0.0"},"keywords":["careermax","mcp","cli","ai-agent","job-search","career","model-context-protocol"],"license":"MIT","mcpName":"io.github.rahulphenomenon/careermax","scripts":{"build":"tsup","dev":"tsup --watch","test":"vitest run","test:watch":"vitest","typecheck":"tsc --noEmit"},"_id":"@careermax/agent-toolkit@0.1.3","_integrity":"sha512-zvXuvA41a0SD8OP1sjQ+1+FTBC0KTBEgrbKocb6AMj7wGeihZvEVS/GBYoYMdpz9ZMHnLQZcl9tZOOQhH1jtwA==","_resolved":"/private/var/folders/xz/x7sz64z10r9fp4rl6t77ypxw0000gq/T/cc3e1620909f298a9b23d88320c6350d/careermax-agent-toolkit-0.1.3.tgz","_from":"file:careermax-agent-toolkit-0.1.3.tgz","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-zvXuvA41a0SD8OP1sjQ+1+FTBC0KTBEgrbKocb6AMj7wGeihZvEVS/GBYoYMdpz9ZMHnLQZcl9tZOOQhH1jtwA==","shasum":"c087c83e9f4959c4c1e9084e053df7494e2709a6","tarball":"https://registry.npmjs.org/@careermax/agent-toolkit/-/agent-toolkit-0.1.3.tgz","fileCount":13,"unpackedSize":228300,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDWzVDGD2EoUaJtrpsC/bRbvuKesGMuGfNddeqMSPzYMwIgPTteSl4QHlLpJUgVcSbSYOzM1Vfgi7P2SQzpOcxjoRs="}]},"_npmUser":{"name":"careermax","email":"support@careermax.ai"},"directories":{},"maintainers":[{"name":"careermax","email":"support@careermax.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-toolkit_0.1.3_1774375105457_0.715723082431559"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-17T13:27:35.522Z","modified":"2026-03-24T17:58:25.703Z","0.1.0":"2026-03-17T13:27:35.774Z","0.1.1":"2026-03-17T13:40:43.409Z","0.1.2":"2026-03-17T16:04:31.560Z","0.1.3":"2026-03-24T17:58:25.621Z"},"bugs":{"url":"https://github.com/rahulphenomenon/careermax/issues"},"license":"MIT","homepage":"https://careermax.ai","keywords":["careermax","mcp","cli","ai-agent","job-search","career","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/rahulphenomenon/careermax.git","directory":"packages/agent-toolkit"},"description":"MCP server and CLI for connecting AI agents to CareerMax","maintainers":[{"name":"careermax","email":"support@careermax.ai"}],"readme":"# @careermax/agent-toolkit\n\n[![npm version](https://img.shields.io/npm/v/@careermax/agent-toolkit.svg)](https://www.npmjs.com/package/@careermax/agent-toolkit)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\nConnect AI agents to CareerMax -- job tracking, resume review, cover letters, interview prep, and more.\n\n## Quick Start\n\n1. Get an API key from [CareerMax Settings](https://careermax.ai/dashboard/settings/api-keys)\n2. Set your API key:\n   ```sh\n   export CAREERMAX_API_KEY=\"cmx_live_...\"\n   ```\n3. Run a command:\n   ```sh\n   npx @careermax/agent-toolkit jobs list\n   ```\n\n## Setup\n\n### Getting an API Key\n\n1. Log in to [CareerMax](https://careermax.ai)\n2. Go to **Settings > API Keys**\n3. Click **Create API Key** and copy the key (starts with `cmx_live_`)\n\n### Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `CAREERMAX_API_KEY` | Yes | Your API key from CareerMax |\n| `CAREERMAX_API_URL` | No | Override the API URL (defaults to CareerMax production) |\n| `CAREERMAX_LOG_LEVEL` | No | Log verbosity (`debug`, `info`, `warn`, `error`) |\n\n## MCP Server\n\nThe toolkit includes an MCP (Model Context Protocol) server that lets AI assistants interact with your CareerMax account directly.\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"careermax\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@careermax/agent-toolkit\", \"mcp\"],\n      \"env\": {\n        \"CAREERMAX_API_KEY\": \"cmx_live_...\"\n      }\n    }\n  }\n}\n```\n\nConfig file locations:\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"careermax\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@careermax/agent-toolkit\", \"mcp\"],\n      \"env\": {\n        \"CAREERMAX_API_KEY\": \"cmx_live_...\"\n      }\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nAny MCP-compatible client can connect. Run the server with:\n\n```sh\nCAREERMAX_API_KEY=\"cmx_live_...\" npx @careermax/agent-toolkit mcp\n```\n\nThe server communicates over stdio using the standard MCP protocol.\n\n## CLI Usage\n\n### Setup\n\n```sh\nexport CAREERMAX_API_KEY=\"cmx_live_...\"\n```\n\nOr install globally:\n\n```sh\nnpm install -g @careermax/agent-toolkit\n```\n\n### Commands\n\n**Get an overview of what CareerMax can do:**\n\n```sh\ncareermax info\n```\n\n**List jobs in your pipeline:**\n\n```sh\ncareermax jobs list\ncareermax jobs list --status applied\ncareermax jobs list --json\n```\n\n**Review your resume with AI:**\n\n```sh\ncareermax resume review\ncareermax resume review --job-id <id>   # tailor feedback to a specific job\n```\n\n**Generate a cover letter:**\n\n```sh\ncareermax cover-letter generate --job-id <id>\n```\n\n**Create a mock interview session:**\n\n```sh\ncareermax interviews create --role \"Software Engineer\" --company Stripe\ncareermax interviews list\n```\n\n**Check your credit balance:**\n\n```sh\ncareermax credits\n```\n\n### Global Flags\n\n| Flag | Description |\n|---|---|\n| `--json` | Output raw JSON instead of formatted tables |\n| `--yes` | Skip confirmation prompts (useful in scripts) |\n| `--api-key <key>` | Override the `CAREERMAX_API_KEY` env var |\n| `--verbose` | Enable detailed logging |\n\n## Available Tools\n\nThese tools are exposed via the MCP server and can be called by any connected AI agent.\n\n| Tool | Description |\n|---|---|\n| `careermax_info` | Get an overview of CareerMax capabilities and the user's account |\n| `jobs_list` | List all jobs in the user's pipeline, with optional status filter |\n| `jobs_get` | Get full details for a specific job |\n| `jobs_add` | Add a new job to the pipeline |\n| `jobs_update` | Update a job's status, notes, or other fields |\n| `resume_review` | Run an AI review of the user's resume, optionally tailored to a job |\n| `cover_letter_generate` | Generate a cover letter for a specific job |\n| `interviews_create` | Create a new mock interview session for a given role and company |\n| `interviews_list` | List past and upcoming interview sessions |\n| `credits_get` | Check the user's current credit balance and plan tier |\n\n## How It Works\n\n```\nAI Agent (Claude, GPT, etc.)\n    |\n    v\nMCP Server / CLI\n    |  (HTTP + Bearer auth)\n    v\nConvex Backend (api/v1/*)\n    |\n    v\nSame AI pipeline as the CareerMax web app\n```\n\nThe toolkit is a thin client. All heavy lifting -- AI resume analysis, cover letter generation, interview simulation -- happens server-side on the same Convex backend that powers the CareerMax web app. Your data stays in your account.\n\n## License\n\nMIT\n","readmeFilename":"README.md","author":{"name":"CareerMax"}}