stdio

Local MCP

Cursor, Claude Desktop, and other stdio MCP hosts can run Career OS on your machine. The process talks JSON-RPC on stdin/stdout, then calls your Career OS site’s /api/account with your session.

Run it

From the repository root:

set CAREER_OS_APP_URL=https://your-career-os-host
npm run mcp

Or open a browser login first:

npm run mcp:login

The binary is bin/career-os-mcp.js (career-os-mcp). Point the MCP client at that command. Set CAREER_OS_APP_URL to the same origin as the web app (this site: origin).

Local-only tools

login — opens a loopback callback so you can sign in. Optional appUrl.
logout — drops the session stored on this machine.

All other tools match the remote connector. PDFs write under ./mcp-output or ~/.career-os/output unless you pass outputPath (sandboxed to those trees).

Environment

Variable	Purpose
`CAREER_OS_APP_URL`	Career OS origin. Required for login and account API calls.
`ILOVEPDF_PUBLIC_KEY` / `ILOVEPDF_SECRET_KEY`	Optional per-request conversion headers. Not stored. Server `ILOVEPDF_*` is preferred.

Cloud agents: Claude, ChatGPT, Cursor HTTP, and VS Code should use the remote connector at /api/mcp, not this stdio server.