Skillmatch MCP server

<!-- mcp-name: io.github.jarmstrong158/skillmatch-mcp -->

SkillMatch MCP

Claude-powered job fit analyzer for people who prove their skills through work, not credentials.

What It Does

SkillMatch is an MCP server that gives Claude access to your GitHub portfolio, resume, and job search preferences. It lets Claude:

• Analyze how well you fit a specific job description based on your actual projects and resume
• Build optimized job search queries tailored to your targets and constraints
• Track every application you submit in a local SQLite database
• Pull your public GitHub repos to highlight relevant work during fit analysis

All data stays local on your machine. Nothing is sent anywhere except public GitHub API calls to fetch your own repos.

Setup

1. Install the dependency

cd skillmatch-mcp
pip install -r requirements.txt

Speaks MCP protocol revision 2026-07-28 over stdio, on SDK mcp>=2.0,<3. It is stateless: no initialize handshake and no session id, with every request carrying its own protocol version and client identity. tools/list and server/discover return ttlMs/cacheScope freshness hints, and tool order is stable across calls so client-side and prompt caches keep hitting.

Upgrading from 1.x: 2.0.0 drops the initialize handshake, so it requires a client that

speaks 2026-07-28. Tool names, schemas, and results are unchanged — only the transport moved.

Stay on 1.x if you need to serve an older client.

2. Add to Claude

Claude Code (CLI):

claude mcp add --scope user skillmatch -- python /path/to/skillmatch-mcp/server.py

Then restart Claude Code.

Claude Desktop:

Open your Claude Desktop configuration file and add SkillMatch to the mcpServers section:

{
  "mcpServers": {
    "skillmatch": {
      "command": "python",
      "args": ["/path/to/skillmatch-mcp/server.py"]
    }
  }
}

Replace /path/to/skillmatch-mcp/server.py with the actual path to server.py on your machine, then restart Claude Desktop.

3. Start using it

After restarting, SkillMatch tools will be available in your conversation. Works in Claude Code and Claude Desktop.

Onboarding

The first time you use SkillMatch, Claude will walk you through a setup conversation. It looks something like this:

You: Help me find a new job.

Claude: I don't have your profile set up yet. Let me ask you a few questions first.

  What is your name?
You: Jordan

Claude: What is your current role?
You: Senior frontend developer

Claude: What roles are you targeting?
You: Staff frontend engineer, senior full-stack engineer

Claude: What is your minimum acceptable salary?
You: 180000

Claude: Are you only looking for remote positions?
You: Yes

Claude: Where are you located?
You: Portland, OR

Claude: Any dealbreakers?
You: No on-call rotations, no defense contractors

Claude: What is your GitHub URL?
You: https://github.com/jordan-dev

Claude: Where is your resume file?
You: C:/Users/jordan/Documents/resume.md

Claude: Got it. Your profile is saved. Let me search for jobs matching your targets.

After onboarding, your profile is saved locally and reused in every future conversation.

Extended Profile (optional)

You can enrich your profile at any time by asking Claude to update it. These fields help Claude reason about nuanced fit:

Shortened. The full README is on GitHub.