onet-match
Map free text to ranked O*NET-SOC occupation codes, with tasks, skills and interests
- 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-matchAdd to claude_desktop_config.json
{
"mcpServers": {
"onet-match": {
"command": "uvx",
"args": [
"onet-match"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"onet-match": {
"command": "uvx",
"args": [
"onet-match"
]
}
}
}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.



