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

Related MCP server: JobSpy MCP Server

Tools

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