Documentation

MCP Installation Guide

Connect your AI assistant to Shortlist's MCP server to manage job applications, queue jobs, and interact with your profile directly from your AI tool.

MCP Endpoint

URLhttps://shortlist.jobs/mcp

Claude Code (CLI)

Run the following command in your terminal:

claude mcp add shortlist --transport http https://shortlist.jobs/mcp

To verify it was added:

claude mcp list

You should see shortlist listed with the HTTP transport.

Codex CLI

Run the following command in your terminal:

codex mcp add shortlist --url https://shortlist.jobs/mcp

To verify it was added:

codex mcp list

Authenticate

For Codex CLI, start the browser login flow:

codex mcp login shortlist

For Claude Code:

  1. 1Restart Claude Code (exit and reopen).
  2. 2Run /mcp and select the shortlist server.
  3. 3A browser window will open — log in with your Shortlist account to authorize the connection.

Troubleshooting

IssueFix
command not found: claudeInstall Claude Code: npm install -g @anthropic-ai/claude-code
MCP not appearing after addRestart Claude Code — MCP servers load on startup
Connection refused / timeoutConfirm the URL is reachable: curl -s -o /dev/null -w "%{http_code}" https://shortlist.jobs/mcp — expect 200 or 405

OpenClaw

Coming soon. OpenClaw integration is not yet available. This section will be updated once support is ready. In the meantime, you can use Claude Code above, or use Claude Code channels to apply straight from your phone by sending messages.

Notes

  • •You must have an active Shortlist account to authenticate with the MCP server.

Need help?

If you get stuck at any point, ask in our Discord and we'll help you out.

Join our Discord