Connect CareerMax to an AI Agent

What you are connecting

The CareerMax agent toolkit is an MCP server and command-line client. It lets a compatible agent use supported CareerMax workflows with a dedicated API key.

The public toolkit can read your CareerMax career context, work with your job pipeline, analyze resume text, draft cover letters and outreach, prepare company research, and create learning material.

It does not expose auto-apply. Job search, profile editing, Career Coach actions, professional-photo generation, and protected PDF delivery are not yet available through the public toolkit.

Ask your agent to connect CareerMax

Paste this into your agent:

Please connect CareerMax to this agent. Install the CareerMax toolkit, run npx -y @careermax/agent-toolkit auth login, walk me through browser authentication, then run npx -y @careermax/agent-toolkit auth check. After that, configure the MCP server with npx -y @careermax/agent-toolkit mcp and verify with a read-only request: “show my CareerMax pipeline.”

The browser login creates a dedicated agent key and stores it locally for the toolkit. The key is not printed in your terminal or pasted into the agent conversation.

Manual API key fallback

1. Sign in to CareerMax.
2. Open Settings > API Keys.
3. Create a key named for the agent you are connecting.
4. Copy the key when it is shown. CareerMax does not show the full value again.

Use one key per agent so you can revoke one connection without disrupting the others. Never paste the key into a conversation or commit it to a repository.

Start the MCP server

If you used browser login on the same machine, use this command as the stdio MCP server:

npx -y @careermax/agent-toolkit mcp

If browser login or local credential storage is not available, set CAREERMAX_API_KEY through the agent's secure environment configuration first. Do not put the key directly in the command because doing so can leave it in shell history.

Verify with a read-only request

Start with:

Show the jobs currently in my CareerMax pipeline.

This verifies the account connection without changing anything. If the agent cannot connect, run npx -y @careermax/agent-toolkit auth check locally or check that the fallback key is present in its environment and has not been revoked.

Understand confirmation

Read-only requests proceed directly. Before CareerMax adds or changes a lasting pipeline record, it returns the exact proposed details and a short-lived confirmation receipt. The agent should show those details and ask you before it continues.

Confirmation is about lasting changes and possible misunderstandings, not about repeating credit costs in every response.

Disconnect

Run npx -y @careermax/agent-toolkit auth logout, remove the MCP configuration from the agent, then revoke the dedicated key in Settings > API Keys if it is still listed.