Developer Tools

Trackly CLI + MCP Server

Search jobs, track applications, and query your job hunt from the terminal or your AI agent.

Install

npm install -g trackly-cli

Quick Start

# Authenticate
trackly login

# Browse recent jobs
trackly jobs

# AI-powered natural language search
trackly ask "PM jobs at fintech companies in SF"

Use an API Key Instead

# Save an API key locally
trackly config --api-key trk_xxxxxxxxxxxxxxxxxxxx

# Or use one just for this command
TRACKLY_API_KEY=trk_xxxxxxxxxxxxxxxxxxxx trackly jobs --json

Commands

Command	Description
`trackly login`	Authenticate with your Trackly account
`trackly jobs`	List recent job postings with filters
`trackly job <id>`	View details for a specific job
`trackly jobs <id>`	Alias for viewing a specific job
`trackly companies`	List monitored companies
`trackly companies search <q>`	Semantic company search
`trackly search <query>`	Alias for semantic company search
`trackly ask <question>`	Natural language job search (AI-powered)
`trackly stats`	View your job tracking metrics
`trackly status`	Alias for stats
`trackly save <id>`	Save a job to your tracker
`trackly apply <id>`	Mark a job as applied
`trackly dismiss <id>`	Dismiss a job
`trackly api-key create`	Generate an API key
`trackly config --api-key trk_xxx`	Store an API key for future commands
`trackly whoami`	Show the current authenticated user
`trackly version`	Show the installed CLI version
`trackly logout`	Sign out and clear credentials

Remote MCP Server

Connect from any MCP client that supports Streamable HTTP, without installing the CLI. Sign in with OAuth in your browser; there is no key to copy.

Server URL

https://mcp.usetrackly.app/api/mcp

Claude Code

claude mcp add --transport http trackly https://mcp.usetrackly.app/api/mcp

# Then, inside Claude Code, run /mcp and choose Authenticate
# to finish Trackly OAuth in your browser.

Step-by-step setup for Claude, ChatGPT, Codex, and other clients, the full list of hosted tools, and the OAuth scopes each tool needs are in the connector guide (tool reference).

Headless or CI: use an API key

For CI jobs and clients that cannot open a browser, create an API key at Settings > Developer and send it as a bearer header. A key is not limited by OAuth scopes and can call every tool, so keep it out of shared or committed config.

Claude Code with an API key

claude mcp add --transport http trackly https://mcp.usetrackly.app/api/mcp \
  --header "Authorization: Bearer trk_your_key_here"

Local MCP Server

The Trackly CLI also includes a local MCP (Model Context Protocol) server that runs on your machine over stdio and uses your CLI login. It adds local-only tools that work with files on your computer, such as checking a resume before upload. Start it manually with trackly mcp (or npx trackly-cli mcp without a global install), or register it in your client:

Claude Code

claude mcp add trackly -- trackly mcp

# Or share it with a project in .mcp.json:
{
  "mcpServers": {
    "trackly": {
      "command": "trackly",
      "args": ["mcp"]
    }
  }
}

.cursor/mcp.json

{
  "mcpServers": {
    "trackly": {
      "command": "trackly",
      "args": ["mcp"]
    }
  }
}

Agent Integration

Once the MCP server is configured, Claude Code and Cursor can access your Trackly data natively. Ask questions in natural language and your agent will use the Trackly tools to fetch real-time job data.

Example prompts

"Find me product manager roles at Series B+ companies in New York"

"What new engineering jobs were posted today?"

"Show my application stats and pipeline"

Requirements

Node.js 20.20 or later on the 20.x line, or 22.22 or later (for the CLI and local MCP server)
A Trackly account (sign up free at usetrackly.app)