README.md
Search jobs across multiple boards and draft proposals automatically.
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
npm install
npm run build
MCP Client Config
Add to your MCP client configuration:
{
"mcpServers": {
"jobs": {
"command": "node",
"args": ["path/to/jobs-mcp/dist/index.js"]
}
}
}
Stack
- TypeScript
- @modelcontextprotocol/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
Tools (8)
search_remote_jobsSearch RemoteOK by tags like typescript, ai, or python.search_hn_jobsSearch HN Who is Hiring threads via Algolia API.search_github_jobsSearch GitHub issues and discussions for job postings.search_arbeitnow_jobsSearch Arbeitnow with remote filter.search_upwork_jobsScrape Upwork job listings by keyword.draft_proposalGenerate a tailored proposal from a job description.job_scanSweep all sources at once with multiple keywords.my_profileReturn saved profile, skills, and project portfolio.Configuration
claude_desktop_config.json
{"mcpServers": {"jobs": {"command": "node", "args": ["path/to/jobs-mcp/dist/index.js"]}}}Try it
→Search for remote AI engineering jobs using the job_scan tool.
→Find recent job postings on GitHub related to TypeScript development.
→Draft a proposal for a job description I found on Upwork using my saved profile.
→Show me my current professional profile and skills stored in the system.