onet-connect-mcp

A read-only MCP server for the O*NET Web Services API — the U.S. Department of Labor's occupational database. It gives a model an occupation's skills, knowledge areas, technology, job outlook, and related occupations, ranked and trimmed for low token use.

• Skills + knowledge ranked by importance (0-100), for mapping jobs to curriculum.
• Technology/tools with hot-technology and in-demand flags.
• Job outlook (bright-outlook status, growth category, salary percentiles).
• Occupation search and related-occupation discovery.

Install

npm install -g @hackspaces/onet-connect-mcp

Run with node (the same way the MCP gateway consumes it):

ONET_API_KEY=... \
  node "$(npm root -g)/@hackspaces/onet-connect-mcp/dist/index.js"

{
  "mcpServers": {
    "onet-connect": {
      "command": "node",
      "args": ["<entrypoint>"],
      "env": { "ONET_API_KEY": "..." }
    }
  }
}

Tools

| Tool | Purpose | | --- | --- | | onet_search_occupations | Find O*NET-SOC codes by keyword | | onet_get_related_occupations | Adjacent career paths for a code | | onet_get_skills | Skills ranked by importance | | onet_get_knowledge | Knowledge areas ranked by importance | | onet_get_technology | Software/tools (hot + in-demand flags) | | onet_compare_skills | Skill gaps between two occupations | | onet_get_outlook | Outlook, bright-outlook, salary percentiles |

Notes

• ONET_API_KEY is required (free registration; no demo mode).
• Newer aggregate codes (e.g. Data Scientists 15-2051.00) carry no O*NET ratings of their own; for skills/knowledge the server falls back to the detailed .01 occupation and notes the substitution.

Development

npm install && npm run typecheck && npm run build && npm test
npm run dev      # stdio, from source
npm run smoke    # live calls across every tool path

License

MIT