# jobs-mcp

MCP server for searching jobs across multiple boards and drafting proposals automatically.

## Features

- **Multi-source search** -- RemoteOK, Hacker News "Who is Hiring", Arbeitnow, GitHub Issues
- **Upwork scraping** -- HTML-based job search with fallback strategies
- **Proposal drafting** -- Auto-selects from 4 templates (MCP, AI Agent, Discord, General) based on keyword scoring
- **Job scan** -- Single command to sweep all sources at once
- **Profile storage** -- Built-in profile for quick reference during applications

## Tools

| Tool | Description |
|------|-------------|
| `search_remote_jobs` | Search RemoteOK by tags (typescript, ai, python, etc.) |
| `search_hn_jobs` | Search HN "Who is Hiring" threads via Algolia API |
| `search_github_jobs` | Search GitHub issues/discussions for job postings |
| `search_arbeitnow_jobs` | Search Arbeitnow with remote filter |
| `search_upwork_jobs` | Scrape Upwork job listings by keyword |
| `draft_proposal` | Generate a tailored proposal from a job description |
| `job_scan` | Sweep all sources at once with multiple keywords |
| `my_profile` | Return saved profile, skills, and project portfolio |

## Setup

```bash
npm install
npm run build
```

### MCP Client Config

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "jobs": {
      "command": "node",
      "args": ["path/to/jobs-mcp/dist/index.js"]
    }
  }
}
```

## Stack

- TypeScript
- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)
- Zod for input validation
- No API keys required (all free/public APIs)

## How Proposal Drafting Works

The `draft_proposal` tool scores a job description against 4 templates:

- **Template A** -- MCP / Model Context Protocol projects
- **Template B** -- AI agents, autonomous systems, LLM integration
- **Template C** -- Discord bots and server management
- **Template D** -- General TypeScript/Python backend work

Keywords in the job title and description are matched against each template. The highest-scoring template is selected and combined with a custom opening that references the specific technologies mentioned in the listing.

## License

MIT