API Reference
Smart Island API
v1.0.0OpenAPI 3.1REST API for the Isle of Man AI Job Market Observatory. Every vacancy is enriched with SOC2020 occupational classification, O*NET skills, automation risk (0–100), and AI Occupational Exposure scores. Data refreshes daily.
Base URL
https://smartisland.im
All endpoints return JSON. No authentication required for read operations.
Endpoints
Jobs
GET/api/jobsJobs
List / search active vacancies
Paginated job listings with full-text search and filters: category, area, hours type, contract type, automation risk level, salary range, employer type, and new within N days. Returns live enrichment data including skills, SOC2020 code, and risk scores.
GET/api/jobs/{id}Jobs
Full job detail with AI enrichment
Complete vacancy record including description, closing date, application URL, and the full AI enrichment panel: skills, tasks, knowledge areas, automation risk score, AIOE score, alternative career paths, and related roles.
Skills
GET/api/skills/registrySkills
Browse canonical skill registry
Returns the full normalised skill taxonomy used by the enrichment pipeline. Use these exact skill names as filter values when querying jobs. Supports search and pagination.
Trends
GET/api/trends/snapshotsTrends
Weekly market snapshot time series
Historical weekly snapshots captured every Sunday. Each snapshot records total vacancies, risk averages, new and disappeared jobs, top skills, top categories, and area breakdowns. Use for trend analysis and week-on-week comparisons.
GET/api/trends/snapshots/{week}Trends
Single weekly snapshot detail
Retrieve a specific week's market snapshot by ISO week label (e.g. 2026-W11). Returns the full breakdown including salary distributions, automation risk histogram, and sector analysis.
🤖
MCP Tools — AI Assistant Integration
An MCP (Model Context Protocol) server runs alongside the REST API, exposing 34 structured tools that AI assistants (Claude, GPT, etc.) can call directly to query the job market without building REST calls manually.
Streamable HTTP: POST https://mcp.smartisland.im/mcp
SSE (legacy): GET https://mcp.smartisland.im/sse
lookup_occupation— Resolve job title to SOC codes
get_occupation_profile— Full occupation profile with AI exposure
list_jobs— Paginated job list with filters
get_job— Full job record + enrichment by ID
search_jobs_by_skills— Match jobs against a skill list
search_jobs_by_knowledge— Match jobs by knowledge areas
get_career_paths— Career transitions with live IOM vacancies
get_skills_gap— Skills gap analysis between two roles
get_skills_transferability— Discover where your skills are valued
get_task_breakdown— Task-level automation analysis
get_occupation_exposure_detail— Deep AI exposure from 3 indices
get_visa_eligibility— UK Skilled Worker visa check
get_salary_comparison— UK vs IoM salary comparison
get_job_market_stats— Live market overview
Test locally: npx @modelcontextprotocol/inspector https://mcp.smartisland.im/sse
Browse all 34 tools →