get_work_authorization

Get work permit status by country.

Overview

Property	Value
Cost	Free
Scope	work_permit_read

Arguments

Argument	Type	Required	Default	Description
country	string	No	-	Two-letter country code (e.g., us, uk, de)

If country is omitted, returns authorization for all countries.

Response

Single Country

{
  "country": "us",
  "country_name": "United States",
  "status": "authorized",
  "visa_type": "H-1B",
  "expires_at": "2026-05-15",
  "notes": "Can work for any US employer"
}

All Countries

{
  "authorizations": [
    {
      "country": "us",
      "country_name": "United States",
      "status": "authorized",
      "visa_type": "H-1B"
    },
    {
      "country": "ca",
      "country_name": "Canada",
      "status": "authorized",
      "visa_type": "Citizen"
    },
    {
      "country": "uk",
      "country_name": "United Kingdom",
      "status": "not_authorized",
      "visa_type": null
    }
  ]
}

Fields

Field	Type	Description
country	string	Two-letter code
country_name	string	Full country name
status	string	authorized, not_authorized, or pending
visa_type	string	Type of visa/permit
expires_at	string	Expiration date (if applicable)
notes	string	Additional details

Example

curlPythonOpenClaw

# Single country
curl -X POST https://jobko.ai/api/mcp/tools/call \
  -H "Authorization: Bearer jk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "get_work_authorization",
    "arguments": {
      "country": "us"
    }
  }'

# All countries
curl -X POST https://jobko.ai/api/mcp/tools/call \
  -H "Authorization: Bearer jk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "get_work_authorization",
    "arguments": {}
  }'

import requests

# Check US authorization
response = requests.post(
    "https://jobko.ai/api/mcp/tools/call",
    headers={"Authorization": "Bearer jk_YOUR_KEY"},
    json={
        "name": "get_work_authorization",
        "arguments": {"country": "us"}
    }
)
auth = response.json()
print(f"US: {auth['status']} ({auth['visa_type']})")

mcporter call jobko.get_work_authorization --country "us"

Common Country Codes

Code	Country
us	United States
uk	United Kingdom
ca	Canada
de	Germany
fr	France
nl	Netherlands
au	Australia
sg	Singapore

Use Cases

• Filter jobs by countries where user can work
• Display visa status in agent responses
• Warn about jobs requiring sponsorship