Skip to content
MCP server

onet-match

Map free text to ranked O*NET-SOC occupation codes, with tasks, skills and interests

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
0.3.5
Listing updated
today

Similar MCP servers

About onet-match

onet-match is an open-source MCP server for hiring and recruiting. It runs locally on your machine and is started by your AI client.

The classifier turns messy text such as job titles, resume bullets, postings or interests into standardised occupation codes using a fine-tuned bge-base retriever and a cross-encoder reranker over all 923 ONET 31.0 occupations. The README reports 51.1% top-1 on held-out ONET text against 20.5% for a TF-IDF baseline, and 65.4% top-1 on messy human-style text, with calibrated confidence (ECE 0.037) and about 47 ms per query on a laptop.

Each match carries SOC code, title, confidence, major group, job zone, RIASEC interest code, description and top tasks, skills and knowledge with O*NET importance and level, plus a profile aggregated across matches. The MCP server runs locally over stdio and offers two read-only tools, match_occupations and get_occupation. A remote streamable HTTP mode is available too.

The first call downloads a model bundle of about 0.5 GB from Hugging Face. The same package ships a Python API, CLI, FastAPI REST service and Docker setup.

Install

Run in a terminal

claude mcp add onet-match -- uvx onet-match

Add to claude_desktop_config.json

{
  "mcpServers": {
    "onet-match": {
      "command": "uvx",
      "args": [
        "onet-match"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "onet-match": {
      "command": "uvx",
      "args": [
        "onet-match"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "onet-match": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "onet-match"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "onet-match": {
      "command": "uvx",
      "args": [
        "onet-match"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "onet-match": {
      "command": "uvx",
      "args": [
        "onet-match"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

match_occupations
Match text to ranked O*NET-SOC occupations (text, top_k)
get_occupation
Get details for one occupation by SOC code

What it does

Ranked occupation matches
Free text goes to SOC codes with calibrated confidence.
Enriched results
Tasks, skills, knowledge and RIASEC interests per match.
Runs locally
No API key or account; the model runs on your machine.
Several interfaces
Python, CLI, REST API, MCP and Docker.
Reported accuracy
51.1% top-1 on O*NET test text and 65.4% on messy text.

Good for

  • Normalise informal job titles in postings
  • Code resume bullets to occupations
  • Suggest careers from a student's interests
  • Batch-code labour-market text for analytics

Pricing

Open source

onet-match FAQ

Does it need an API key?

No. It runs locally and is MIT licensed.

How accurate is it?

The README reports 51.1% top-1 and 79.1% top-5 on held-out O*NET text, and 65.4% and 92.9% on messy text.

How big is the download?

The first call fetches a model bundle of about 0.5 GB.

What MCP tools exist?

match_occupations and get_occupation, both read-only.

Is onet-match free?

Yes. onet-match is open source, so you can use and self-host it for free.

How do I add onet-match to Claude Code?

Run this command in your terminal: claude mcp add onet-match -- uvx onet-match

What are the best alternatives to onet-match?

The closest alternatives to onet-match are headroom, omniget, next-ai-draw-io, mcp-for-blender and Claude Code Ultimate Guide.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers