About server
server is an MCP server published by git+workclear-au in the AI category: mCP server for Australian contractor licence verification via WorkClear API.
Install
npx @workclear/mcp-serverclaude mcp add workclear-mcp -- npx -y @workclear/mcp-servernpx -y @workclear/mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
check_licence_statusQuick check whether an Australian contractor licence is currently valid. Returns a yes/no validity flag plus status and expiry date.
Parameters not published.
get_coverageGet WorkClear
Parameters not published.
search_licencesSearch Australian contractor licences by business name, person name, or ABN. Returns matching licence records. Supports state filtering and result limits.
Parameters not published.
verify_licenceVerify an Australian contractor licence by its licence number. Returns full licence details including holder name, status, class, expiry, and ABN. Optionally filter by state.
Parameters not published.
Ask AI
Ask AI about server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
4 checks have not been run yet.
README
@workclear/mcp-server
MCP (Model Context Protocol) server for Australian contractor licence verification via the WorkClear API.
Verify contractor licences across QLD, NSW, VIC, SA, ACT, and NT directly from AI agents like Claude, ChatGPT, or any MCP-compatible client.
Quick Start
1. Get an API key
Sign up at workclear.com.au and create an API key in your dashboard.
2. Configure your MCP client
Add to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"workclear": {
"command": "npx",
"args": ["-y", "@workclear/mcp-server"],
"env": {
"WORKCLEAR_API_KEY": "wc_live_your_key_here"
}
}
}
}
Or run directly:
WORKCLEAR_API_KEY=wc_live_your_key_here npx @workclear/mcp-server
Tools
verify_licence
Verify a specific contractor licence by number.
| Parameter | Type | Required | Description |
|---|---|---|---|
licence_number |
string | ✅ | The licence number to verify |
state |
string | ❌ | State code (QLD, NSW, VIC, ACT, NT, WA, SA, TAS) |
Example: "Verify QBCC licence 54898"
search_licences
Search licences by business name, person name, or ABN.
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | ✅ | Search term |
state |
string | ❌ | Filter by state |
limit |
number | ❌ | Max results (1-50, default 10) |
Example: "Search for licence holders named Smith in QLD"
check_licence_status
Quick validity check — is a licence currently active?
| Parameter | Type | Required | Description |
|---|---|---|---|
licence_number |
string | ✅ | The licence number |
state |
string | ❌ | State code (recommended) |
Example: "Is licence 12345 still valid in NSW?"
get_coverage
Check which states are available and how many records are in the database.
No parameters required.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
WORKCLEAR_API_KEY |
✅ | — | Your WorkClear API key |
WORKCLEAR_API_URL |
❌ | https://workclear.com.au |
API base URL (for self-hosted) |
API Limits
Your API call limits depend on your WorkClear plan:
| Plan | API + MCP calls/month | Price |
|---|---|---|
| Free | Web only (no API) | $0 |
| Pro | 1,000 | $29/mo |
| Business | 10,000 | $99/mo |
| Enterprise | Unlimited | Custom |
Each MCP tool call counts as one API call. Upgrade at workclear.com.au/pricing.
Development
# Install dependencies
npm install
# Build
npm run build
# Run in development mode
WORKCLEAR_API_KEY=your_key npm run dev
Publishing
# Bump version
npm version patch # 1.0.0 → 1.0.1
# Build and publish
npm run build
npm publish --access public
License
MIT — see LICENSE for details.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.