anzsco-mcp

Live endpoint: https://mcp.anzsco.com.au/ — no auth required, no install needed.

Model Context Protocol (MCP) server for anzsco.com.au — lets AI assistants search and explore Australian occupation codes (ANZSCO), visa pathways, state nominations, and the latest SkillSelect invitation round data.

Built as a Cloudflare Worker — stateless, globally distributed, free-tier friendly.

What it does

Australian skilled migration requires matching a job role to an ANZSCO occupation code. The right code determines:

• Which visa subclasses you can apply for (189 / 190 / 491 / 482 / 186 / 494)

• Which states and territories can nominate you

• Which skills assessment authority assesses your qualifications

• Your SkillSelect points and invitation probability

This MCP server exposes all of that as 8 AI-callable tools, so Claude (and other AI assistants) can answer questions like:

• "Can a .NET developer apply for visa 189?"

• "What ANZSCO code is a React developer?"

• "Does NSW nominate civil engineers for subclass 190?"

• "What was the latest SkillSelect points cutoff?"

8 Tools

Live Endpoint

https://mcp.anzsco.com.au/

Transport: JSON-RPC 2.0 over HTTP POST. Stateless (no SSE). No authentication required.

Claude Desktop Integration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "anzsco": {
      "transport": {
        "type": "http",
        "url": "https://mcp.anzsco.com.au/"
      }
    }
  }
}

Restart Claude Desktop — you'll see ANZSCO tools available in the tool selector.

Claude Code (CLI) Integration

claude mcp add anzsco --transport http https://mcp.anzsco.com.au/

curl Examples

MCP_URL="https://mcp.anzsco.com.au"

# Initialize
curl -s -X POST "$MCP_URL/" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","clientInfo":{"name":"test","version":"1.0"},"capabilities":{}}}' | jq .

# List tools
curl -s -X POST "$MCP_URL/" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | jq .result.tools[].name

# Search: .net developer
curl -s -X POST "$MCP_URL/" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_occupations","arguments":{"query":".net developer"}}}' | jq .

# Visa pathway: can 261312 apply for 189?
curl -s -X POST "$MCP_URL/" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"get_visa_pathway","arguments":{"code":"261312","subclass":"189"}}}' | jq .

# Latest SkillSelect round
curl -s -X POST "$MCP_URL/" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":6,"method":"tools/call","params":{"name":"get_latest_skillselect_round","arguments":{}}}' | jq .

Quick Reference: Common ANZSCO Codes

Deploy Your Own

Prerequisites: Node.js 18+, Wrangler CLI, Cloudflare account.

git clone https://github.com/NaveenSharma/anzsco-mcp.git
cd anzsco-mcp
npm install
cp wrangler.toml.example wrangler.toml
# Edit wrangler.toml — set your account_id
npm run deploy

The Worker fetches live data from https://anzsco.com.au/api/ with a 5-minute Cloudflare edge cache. No environment variables or secrets required.

Data Sources

Architecture

AI Client (Claude, etc.)
    │ POST / (JSON-RPC 2.0)
    ▼
Cloudflare Worker (this repo)
    │ fetch with CF edge cache (5 min TTL)
    ▼
anzsco.com.au API
    │
    ▼
ANZSCO database + SkillSelect data

• Stateless — no persistent storage in the Worker

• No auth — public read-only occupation reference data

• Globally distributed — served from 300+ Cloudflare PoPs

• MCP spec: 2024-11-05

Listings

• Glama: glama.ai/mcp/servers/NaveenSharma/anzsco-mcp

• Smithery: smithery.ai/server/anzsco-mcp (pending)

• Docs / demo: anzsco.com.au/ai

Contributing

Contributions welcome. The most useful additions are:

• Updating occupation data when ANZSCO publishes new codes

• Adding technology synonyms to src/synonyms.ts

• Fixing SkillSelect round data as new rounds are published

• Improving tool descriptions for better AI discoverability

PRs and issues welcome at github.com/NaveenSharma/anzsco-mcp.

License

MIT — see LICENSE.

Data sourced from publicly available ANZSCO and Department of Home Affairs records. Not affiliated with the Australian Bureau of Statistics or the Department of Home Affairs.