searchsteward-mcp 0.1.0

MCP server for SearchSteward — search job matches, read score breakdowns, log applications, and pull negotiation prep from any MCP client.

searchsteward-mcp

An MCP server that connects SearchSteward to Claude Desktop, Claude Code, and any other MCP client. Search your job matches, read score breakdowns, log applications, and pull negotiation prep — from inside Claude.

Requires an active Radar subscription and a SearchSteward API key.

Get an API key

In SearchSteward: Settings → Connect to Claude → Create API key. The key (ss_pat_…) is shown once — copy it immediately.

Claude Code

claude mcp add searchsteward -e SEARCHSTEWARD_API_KEY=ss_pat_... -- uvx searchsteward-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "searchsteward": {
      "command": "uvx",
      "args": ["searchsteward-mcp"],
      "env": { "SEARCHSTEWARD_API_KEY": "ss_pat_..." }
    }
  }
}

Tools

Tool	What it does
search_matches	Search your job matches (score-ranked; each row carries a score).
get_job	Full detail for one match, including the score breakdown and ghost-listing signal.
list_applications	List your tracked applications.
log_application	Mark a match as applied (promotes it to a tracked application).
update_application	Change an application's status and/or add a note.
get_negotiation_playbook	Generate an offer-negotiation playbook (runs an LLM job; Radar quota applies).

Configuration

Env var	Required	Default
SEARCHSTEWARD_API_KEY	yes	—
SEARCHSTEWARD_API_BASE	no	https://searchsteward.com

SEARCHSTEWARD_API_BASE must be HTTPS (localhost is exempt for local development) — the server refuses to start otherwise, since the key would otherwise travel in cleartext.

Notes

• Access is suspended while your subscription is paused and resumes automatically on unpause.
• Revoke a key any time from Settings → Connect to Claude; revocation takes effect immediately.
• Job descriptions returned by get_job are untrusted web content — treat them as data, not instructions.

Development

cd mcp-server
pip install -e ".[test]"
pytest