jobdatapool-mcp

# jobdatapool-mcp A local Model Context Protocol server for JobDataPool job listings, source provenance, dataset QA, company briefs, and market scans. This Python package is a parity-oriented port of the Node JobDataPool MCP surface. It exposes the same six core tools, three resources, and three guided prompts described on the JobDataPool MCP page. ## Requirements - Python 3.10+ - An MCP-compatible client that can launch a local stdio server, such as Claude Desktop, Claude Code, Cursor, or Windsurf ## Install ```bash pip install jobdatapool-mcp ``` ## Run locally ```bash jobdatapool-mcp ``` The server uses `https://jobdatapool.com` by default. For local site testing, point it at your local JobDataPool build: ```bash JOBDATAPOOL_BASE_URL=http://localhost:8888 jobdatapool-mcp ``` The dataset snapshot is cached for 10 minutes by default. Override that with: ```bash JOBDATAPOOL_CACHE_TTL_SECONDS=60 jobdatapool-mcp ``` ## MCP client config ### Claude Desktop / Claude Code / Cursor / Windsurf After installing from PyPI, use the package command directly: ```json { "mcpServers": { "jobdatapool": { "command": "jobdatapool-mcp", "env": { "JOBDATAPOOL_BASE_URL": "https://jobdatapool.com" } } } } ``` For a local checkout before publishing, run through Python instead: ```json { "mcpServers": { "jobdatapool": { "command": "python", "args": ["-m", "jobdatapool_mcp.server"], "cwd": "/absolute/path/to/jobdatapool-mcp", "env": { "JOBDATAPOOL_BASE_URL": "https://jobdatapool.com" } } } } ``` ## Tools ### `search_jobs` Search the current JobDataPool snapshot by keyword and filters. Useful arguments include: - `query` - `limit` - `location` - `country` - `company` - `industry` - `skill` - `seniority` - `employment_type` - `remote` - `posted_within_days` - `salary` - `sort` Example prompts: ```text Find remote senior Python security jobs in the US. ``` ```text Search JobData…