Server definition
- Hash
- sha256:429e16ba985a71bcc637eab0fed875b343ff4c3c575fad85475e904be171e9c2
- What it is
- What a remote MCP server returned when asked what it offers: 72 tools
The blob, as servednamed by its sha256
{
"instructions": "VeilPoint Opportunity Exchange is economic-intelligence infrastructure for businesses, places, industries, workforce, demand and supply, with governed public evidence, a structured economic graph, and AI-ready access. It connects municipal economies, industries, businesses, workforce demand, wages, housing, trade, facilities, training and emerging activity; job postings are analyzed as labour-demand evidence rather than marketplace inventory. The model is geographically extensible; Saskatchewan is the current evidence footprint, alongside national occupational, wage, vacancy and housing reference data. Every result carries meta.dataStatus — check it before treating figures as measured. For a multi-domain natural-language question, start with investigate_economic_question; inspect its plan, limitations, and nested evidence before synthesis. Resolve user language to a canonical OEX entity before joining datasets. A missing fact is unknown, never zero or false. OEX marks a comparison comparable only when every material observation has compatible concepts, units, geography, and periods. Read meta.evidence before quoting a result, preserve material qualifications, and cite the canonical URL returned with the resource. Atomic public graph assertions also carry citation.id and citation.resolver; resolve either through /api/v1/citations/{citationId} or resolve_citation instead of reconstructing provenance from display text. 64 upstream datasets are registered; 58 are approved for defined uses. 21 runtime providers: 17 runtime providers serve published evidence: Advertised job demand, Community business counts, Community GDP engine, Cost of living, Education and apprenticeship pipeline, Geography, Housing value and supply evidence, Market Basket Measure costs, Municipal business licences, National occupational projection context, Occupational skills and requirements, Open-source economic signals, Rents, Trade, Training catalogue, Training pathways and crosswalks, Wages & vacancies. No runtime provider serves preview evidence. 4 runtime providers are empty. Do not use preview figures for employment, investment, or policy decisions; check each record's provenance and /about/data. OEX answers two different kinds of question. (1) Regional economic intelligence for Saskatchewan and Canada — wages, rents, hiring, trade, procurement, GDP, licensed businesses and the relationships between them. Start with investigate_economic_question for anything open-ended, or resolve_entities when you have a name and need the canonical id. Every investigation also returns an `inquiry` block, and inspect_knowledge_frontier reaches the same thing directly for one subject: the registered questions OEX asked, what it could not conclude and why, the governed dependency standing in the way where naming it is safe, what class of evidence would resolve it, and which registered question follows. Following one of those and asking again is the loop OEX is built around — an answer that changes because the evidence changed, never because anything was marked. It is not a task list: it carries no identifiers to act on and OEX accepts no report that a dependency was addressed. (2) Business Health: a diagnostic OEX runs for an individual business, reporting what is wrong with how it appears in public data, what to do about it, and verifying the fix. Call list_health_capabilities first to see what it can inspect, fix, generate and verify — it is generated from the check registry, so it never promises something OEX cannot do. To try the workflow, call create_sandbox_business and then get_business_health — sandbox subjects are synthetic and let you walk the whole thing, including correcting the record and rechecking; run_business_study composes the deeper three-instrument analysis over the same evidence, and check_opportunity_readiness reports, for each public procurement notice whose categories overlap what the business publishes, what about its representation is in order and what is not — each gap naming the health check that owns it. OEX never scores a business numerically, and reports \"we could not look\" as distinct from \"we looked and found nothing\". Findings about a real business can be acted on directly on that business's own website; changing what OEX itself publishes requires claiming the record, which only a person can do — explain_business_claim describes how.",
"tools": [
{
"description": "Compare the supply categories a business has published against the UNSPSC categories official buyers have requested. Returns category compatibility only, classed as inferred_compatibility: it establishes no qualification, eligibility, supplier relationship, competitiveness, or likelihood of award, and it never reads capabilities the business withheld from publication. Use inspect_procurement_activity for the buyer-side observations themselves.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"businessId": {
"description": "Exact graph business id, e.g. business:<canonical-id>, from resolve_entities.",
"type": "string"
},
"includeHistory": {
"description": "Include closed notices as historical demand evidence; default false.",
"type": "boolean"
},
"limit": {
"description": "Maximum overlapping notices returned; default 50.",
"maximum": 200,
"minimum": 0,
"type": "integer"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "assess_procurement_relevance",
"outputSchema": null
},
{
"description": "Report occupational demand, credential demand, training availability and a training-route constraint indicator separately. It does not combine them into a shortage claim: a shortage is a claim about labour supply and requires a credential-holder denominator OEX does not hold. Advertised record counts are counts of advertisements, not of unfilled positions or people needed, and are not deduplicated across employers.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Maximum rows per view; default 50.",
"maximum": 200,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "assess_workforce_demand",
"outputSchema": null
},
{
"description": "Run Business Health on a real business from details you supply — the free public check. Use this when someone asks about *their own* business: it needs no account, stores nothing, and creates no record. Supply the website to unlock the nine checks that read the site. OEX asserts nothing about the business and holds no record of it; the report describes the details given and the site named. For experimenting with the workflow instead, use create_sandbox_business.",
"inputSchema": {
"properties": {
"address": {
"type": "string"
},
"category": {
"description": "What the business does.",
"type": "string"
},
"description": {
"description": "How the business describes itself.",
"type": "string"
},
"name": {
"description": "The business name.",
"type": "string"
},
"phone": {
"type": "string"
},
"website": {
"description": "Domain or URL. Worth supplying — nine checks depend on it.",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "check_business_health",
"outputSchema": null
},
{
"description": "Check whether requested community observations share compatible concepts, units, geographic boundaries, and reference periods; return explicit reasons where they do not.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"bundle": {
"description": "Comparison metric preset; defaults to municipal-economic-profile-v1.",
"enum": [
"municipal-economic-profile-v1"
],
"type": "string"
},
"entities": {
"description": "Municipality names, local slugs, or SGC codes.",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 2,
"type": "array",
"uniqueItems": true
},
"metrics": {
"description": "Optional additional fact metrics.",
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"entities"
],
"type": "object"
},
"name": "check_comparability",
"outputSchema": null
},
{
"description": "For each public procurement notice whose requested categories overlap what this business has published, what about the business's OEX representation is in order and what is not. Every gap names the Business Health check that owns it, so the fix is the same one the health report already offers. Establishes category compatibility only: never qualification, eligibility, a supplier relationship, competitiveness, or any likelihood of award. There is no fit score and no probability, and asking for one will not produce one.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
},
"limit": {
"description": "Optional, default 5. How many overlapping notices to assess.",
"type": "number"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "check_opportunity_readiness",
"outputSchema": null
},
{
"description": "Compare 2–10 Saskatchewan communities and return explicit missing-data and comparability results for every requested metric.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"bundle": {
"description": "Comparison metric preset; defaults to municipal-economic-profile-v1.",
"enum": [
"municipal-economic-profile-v1"
],
"type": "string"
},
"entities": {
"description": "Municipality names, local slugs, or SGC codes.",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 2,
"type": "array",
"uniqueItems": true
},
"metrics": {
"description": "Optional additional fact metrics.",
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"entities"
],
"type": "object"
},
"name": "compare_communities",
"outputSchema": null
},
{
"description": "Compare 2–10 exact Saskatchewan municipalities using the newest governed fact for each standard economic metric. A metric is comparable only when all resolved municipalities have the same unit and reference period; missing and mismatched evidence is returned explicitly.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"bundle": {
"description": "Comparison metric preset; defaults to municipal-economic-profile-v1.",
"enum": [
"municipal-economic-profile-v1"
],
"type": "string"
},
"entities": {
"description": "Municipality names, local slugs, or SGC codes.",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 2,
"type": "array",
"uniqueItems": true
},
"metrics": {
"description": "Optional additional fact metrics.",
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"entities"
],
"type": "object"
},
"name": "compare_municipalities",
"outputSchema": null
},
{
"description": "The wage-vs-cost join: what an hourly wage actually leaves over each month in every Saskatchewan community, after tax, housing, utilities and commuting. Pass occupation (models its median wage, with posting counts; their truth state is in meta.evidence) or wage.",
"inputSchema": {
"properties": {
"occupation": {
"description": "Role id from list_roles.",
"type": "string"
},
"wage": {
"description": "Explicit hourly wage, CAD.",
"type": "number"
}
},
"type": "object"
},
"name": "compare_outcomes",
"outputSchema": null
},
{
"description": "Compare two or three roles using the shared occupation fields: wages, demand, outlook, entry requirements and work profile.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"ids": {
"description": "Two or three role ids from list_roles.",
"items": {
"type": "string"
},
"maxItems": 3,
"minItems": 2,
"type": "array",
"uniqueItems": true
}
},
"required": [
"ids"
],
"type": "object"
},
"name": "compare_roles",
"outputSchema": null
},
{
"description": "Start here to try Business Health. Creates a synthetic business you may then operate, and returns its id. Sandbox businesses never appear in OEX search, the directory or any public count — they exist so the workflow can be walked end to end. Give it whatever characteristics the scenario you want to test needs; leaving fields out produces a business with gaps to find.",
"inputSchema": {
"properties": {
"address": {
"description": "Optional civic address.",
"type": "string"
},
"category": {
"description": "Optional industry or category.",
"type": "string"
},
"description": {
"description": "Optional description of what it does.",
"type": "string"
},
"name": {
"description": "Trading name for the synthetic business.",
"type": "string"
},
"phone": {
"description": "Optional phone number.",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "create_sandbox_business",
"outputSchema": null
},
{
"description": "The decision tool: evaluate realistic routes into work for a person's stated credentials, education, experience, driver licence, relocation boundary, housing and family needs, savings, and retraining limit. Returns pass/conflict/unknown plus the same ordered, versioned evidence panel used by REST and the human evaluator. OSINT and placeholder values are excluded from ranking. Request-scoped: constraints are evaluated in-process and never stored.",
"inputSchema": {
"properties": {
"allowedMunicipalityIds": {
"description": "Optional destination allowlist.",
"items": {
"enum": [
"saskatoon",
"regina",
"prince-albert",
"moose-jaw",
"swift-current",
"yorkton",
"north-battleford",
"weyburn",
"estevan",
"lloydminster",
"warman",
"martensville",
"humboldt",
"melfort",
"meadow-lake",
"melville",
"kindersley",
"nipawin",
"rosetown",
"la-ronge"
],
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"bedroomsRequired": {
"description": "Rental unit size required by the household.",
"enum": [
"bachelor",
"oneBedroom",
"twoBedroom",
"threeBedroomPlus"
],
"type": "string"
},
"credentials": {
"description": "Credential names held and current, e.g. \"WHMIS\", \"Class 5 Licence\".",
"items": {
"type": "string"
},
"type": "array"
},
"currentMunicipalityId": {
"description": "Current community, required when maximumRelocationKm is supplied.",
"enum": [
"saskatoon",
"regina",
"prince-albert",
"moose-jaw",
"swift-current",
"yorkton",
"north-battleford",
"weyburn",
"estevan",
"lloydminster",
"warman",
"martensville",
"humboldt",
"melfort",
"meadow-lake",
"melville",
"kindersley",
"nipawin",
"rosetown",
"la-ronge"
],
"type": "string"
},
"educationLevel": {
"description": "Highest education level.",
"enum": [
"Secondary school",
"Secondary plus short certificate",
"Secondary plus trade certificate",
"Apprenticeship or journeyperson",
"Diploma",
"Bachelor degree"
],
"type": "string"
},
"experienceAreas": {
"description": "Capability areas with real working experience.",
"items": {
"enum": [
"mechanical_systems",
"safety_systems",
"field_operations",
"process_monitoring",
"electrical_basics",
"coordination_admin",
"care_delivery",
"customer_service",
"digital_systems",
"logistics_handling",
"physical_operations"
],
"type": "string"
},
"type": "array"
},
"householdSize": {
"description": "People represented by the regional Market Basket Measure basket.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"housingBudgetMonthly": {
"description": "Maximum monthly rent for the requested household.",
"maximum": 50000,
"minimum": 1,
"type": "number"
},
"incomeEarners": {
"description": "Income earners sharing housing and utilities.",
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"licenceClass": {
"description": "Highest Saskatchewan driver licence currently held.",
"enum": [
"None",
"Class 5",
"Class 3",
"Class 1A"
],
"type": "string"
},
"limit": {
"description": "Ranked list size (default 8, max 20).",
"type": "number"
},
"maximumRelocationKm": {
"description": "Maximum move from currentMunicipalityId; zero means local only.",
"maximum": 2500,
"minimum": 0,
"type": "number"
},
"maximumRetrainingWeeks": {
"description": "Maximum acceptable retraining time; zero means direct entry.",
"maximum": 520,
"minimum": 0,
"type": "number"
},
"savingsDollars": {
"description": "Cash available for training before funding.",
"maximum": 1000000,
"minimum": 0,
"type": "number"
},
"targetOccupationId": {
"description": "Role id from list_roles — evaluates that target in depth.",
"type": "string"
},
"vehicleAvailable": {
"description": "Whether the scenario includes a vehicle commute.",
"type": "boolean"
}
},
"type": "object"
},
"name": "evaluate_pathways",
"outputSchema": null
},
{
"description": "What claiming a business on OEX involves, and how to start. Call this after check_business_health when the person wants to act on the findings inside OEX rather than only on their own website — claiming is what unlocks correcting the record, granting consent and verified rechecks. Read-only: it explains the process and returns the URL. You cannot claim a business on someone's behalf, and OEX will not accept an agent's word for who owns a business.",
"inputSchema": {
"properties": {
"businessName": {
"description": "Optional — the business being asked about, echoed back for context.",
"type": "string"
}
},
"type": "object"
},
"name": "explain_business_claim",
"outputSchema": null
},
{
"description": "Explain the OEX A–D record-confidence vocabulary, its weakest-input rule for derived values, and the interpretation contract.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"confidence": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
}
},
"type": "object"
},
"name": "explain_confidence",
"outputSchema": null
},
{
"description": "Explain what an OEX truth state permits an agent to claim and return the complete interpretation contract.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"truthState": {
"enum": [
"preview",
"snapshot",
"measured_aggregate",
"mixed",
"live",
"metadata"
],
"type": "string"
}
},
"type": "object"
},
"name": "explain_truth_state",
"outputSchema": null
},
{
"description": "Find entities connected through governed graph predicates, with source, truth state, confidence, and hop annotations.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"bundle": {
"description": "Bounded metric preset. municipal-economic-profile-v1 requires one municipality entity.",
"enum": [
"municipal-economic-profile-v1"
],
"type": "string"
},
"depth": {
"description": "Hops to expand outward from entity; default 1. Above 1 adds an expansion block of nodes and edges annotated with the hop that reached them, so a containment chain such as municipality -> census-division -> economic-region can be fetched in one call instead of three. Requires entity.",
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"entity": {
"description": "Exact name, slug, graph id, NOC code, SGC code, source id, or provider id.",
"type": "string"
},
"geography": {
"description": "Optional exact municipality name, slug, or SGC code for geography-scoped facts.",
"type": "string"
},
"limit": {
"description": "Maximum facts, relationships, or listed entities; default 25.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"maxNodes": {
"description": "Ceiling on entities across the whole expansion; default 200. Distinct from limit, which bounds one level — without it a depth of 2 from a municipality would pull every business in it.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"metrics": {
"description": "Fact metrics, e.g. population.",
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"minimumConfidence": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
},
"predicates": {
"description": "Relationship predicates, e.g. classified_as or serves.",
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"referencePeriodEnd": {
"description": "Inclusive ISO-8601 upper bound for fact reference periods.",
"type": "string"
},
"referencePeriodStart": {
"description": "Inclusive ISO-8601 lower bound for fact reference periods.",
"type": "string"
},
"truthStates": {
"items": {
"enum": [
"live",
"snapshot",
"measured_aggregate",
"derived",
"mixed",
"metadata",
"unavailable"
],
"type": "string"
},
"maxItems": 7,
"type": "array"
},
"type": {
"description": "Optional entity-type constraint.",
"enum": [
"occupation",
"municipality",
"geography",
"sector",
"training-program",
"noc-unit-group",
"data-source",
"data-provider",
"economic-region",
"census-division",
"trade-region",
"naics-industry",
"industrial-facility",
"open-source-signal",
"organization",
"project",
"procurement-notice",
"product-or-service",
"job-posting",
"employer",
"business-source-observation",
"establishment",
"business"
],
"type": "string"
}
},
"type": "object"
},
"name": "find_connected_entities",
"outputSchema": null
},
{
"description": "Find businesses whose published purchasing categories match the categories a business has published as things it can supply. Returns potential_compatibility only: it is not a customer list, and a business appearing in it has expressed no interest in anything. Nothing is matched on industry. Withheld categories on either side are excluded.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"businessId": {
"description": "Exact graph business id, e.g. business:<canonical-id>, from resolve_entities.",
"type": "string"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "find_potential_customers",
"outputSchema": null
},
{
"description": "Find businesses whose published supply categories match the categories a business has published as things it buys. Returns potential_compatibility only: no relationship is asserted, neither party has said they have done business, and neither may be aware of the other. Nothing is matched on industry. Withheld categories on either side are excluded.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"businessId": {
"description": "Exact graph business id, e.g. business:<canonical-id>, from resolve_entities.",
"type": "string"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "find_potential_suppliers",
"outputSchema": null
},
{
"description": "Retrieve the governed context and evidence boundary for one business entity. Licence presence establishes snapshot presence only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Canonical business id from search_businesses or a graph query.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_business_evidence",
"outputSchema": null
},
{
"description": "The full health report for a sandbox business: the headline, findings worth attention with an action each, invitations, what passed, and what could not be evaluated. The headline is categorical — OEX publishes no numeric health score, in any cycle.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "get_business_health",
"outputSchema": null
},
{
"description": "The same report as markdown — the form an owner would hand to whoever maintains their website.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "get_business_health_markdown",
"outputSchema": null
},
{
"description": "One community’s GDP report by 2021 SGC census subdivision code (e.g. 4708004 for Swift Current): central estimate with the income/production range and every sector’s amount and percentage share, or the suppression reason where the data cannot support a point estimate. Codes come from get_economy_overview or /api/v1/economy.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"code": {
"description": "7-digit 2021 SGC census subdivision code.",
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "get_community_economy",
"outputSchema": null
},
{
"description": "Retrieve one municipality as a governed economic profile with canonical identity, available evidence, links, and qualifications.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Municipality name, slug, or SGC code.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_community_profile",
"outputSchema": null
},
{
"description": "Read runtime provider contracts grouped as evidence, preview, planned, first-party and derived. Only the evidence group is eligible to support factual claims.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_data_providers",
"outputSchema": null
},
{
"description": "Read the governed upstream source registry: publisher datasets, stable source ids, licence decisions, approved and excluded uses, checked releases, materialization bindings and refresh controls.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_data_sources",
"outputSchema": null
},
{
"description": "Get one governed economic signal by its source-stable id, including provenance, lifecycle state, mappings and uncertainty boundaries.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Signal id from list_economic_signals.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_economic_signal",
"outputSchema": null
},
{
"description": "Modeled community GDP for Saskatchewan: official provincial sector GDP (36-10-0711-01, 2022 current dollars) allocated across all 951 census subdivisions by measured activity weights, reconciling to provincial totals. Returns benchmark/allocated/residual totals, top communities, the official 2017–2025 Saskatchewan real-GDP series, and the calculation version. Community figures are structured estimates, not official measurements.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_economy_overview",
"outputSchema": null
},
{
"description": "Backward-compatible alias for list_economic_signals.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"maximum": 1000,
"minimum": 0,
"type": "number"
},
"offset": {
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"name": "get_emerging_signals",
"outputSchema": null
},
{
"description": "Retrieve one governed entity record with its evidence, provenance, canonical links, and permitted interpretation.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Exact canonical id, local slug, or name from resolve_entities.",
"type": "string"
},
"type": {
"enum": [
"occupation",
"municipality",
"geography",
"sector",
"training-program",
"noc-unit-group",
"data-source",
"data-provider",
"economic-region",
"census-division",
"trade-region",
"naics-industry",
"industrial-facility",
"open-source-signal",
"organization",
"project",
"procurement-notice",
"product-or-service",
"job-posting",
"employer",
"business-source-observation",
"establishment",
"business"
],
"type": "string"
}
},
"required": [
"type",
"id"
],
"type": "object"
},
"name": "get_entity",
"outputSchema": null
},
{
"description": "Fetch the governed context for one resolved entity in a single call. Accepts a canonical id, local slug or exact name and routes to the existing occupation, municipality, sector, training, NOC or source resource so evidence and provenance are preserved.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Exact canonical id, local slug, or name from resolve_entities.",
"type": "string"
},
"type": {
"enum": [
"occupation",
"municipality",
"geography",
"sector",
"training-program",
"noc-unit-group",
"data-source",
"data-provider",
"economic-region",
"census-division",
"trade-region",
"naics-industry",
"industrial-facility",
"open-source-signal",
"organization",
"project",
"procurement-notice",
"product-or-service",
"job-posting",
"employer",
"business-source-observation",
"establishment",
"business"
],
"type": "string"
}
},
"required": [
"type",
"id"
],
"type": "object"
},
"name": "get_entity_context",
"outputSchema": null
},
{
"description": "Retrieve a governed upstream source or runtime provider and its lineage, licence boundary, releases, and serving status.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Optional registered source id from get_data_sources or provider id from get_data_providers.",
"type": "string"
}
},
"type": "object"
},
"name": "get_evidence",
"outputSchema": null
},
{
"description": "Get an asset OEX generates from the business's own record: 'local-business-jsonld' or 'corrected-info-block'.",
"inputSchema": {
"properties": {
"assetId": {
"enum": [
"local-business-jsonld",
"corrected-info-block"
],
"type": "string"
},
"businessId": {
"type": "string"
}
},
"required": [
"businessId",
"assetId"
],
"type": "object"
},
"name": "get_generated_asset",
"outputSchema": null
},
{
"description": "The event history for a sandbox business: what was detected, what the owner reported, and what a recheck verified — with the timestamps that make the sequence auditable.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
},
"checkId": {
"type": "string"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "get_health_action_history",
"outputSchema": null
},
{
"description": "Return the current database graph inventory by entity type, predicate and metric plus deterministic core reconciliation. ok=true means every governed core entity, alias, edge and fact is present; additional materializers may add records.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_knowledge_graph_status",
"outputSchema": null
},
{
"description": "Retrieve governed Saskatchewan labour-demand evidence while keeping advertised openings, statistical vacancies, live listings, and modelled sector allocations distinct.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_labour_demand",
"outputSchema": null
},
{
"description": "Evidence availability and confidence-gate work queue for all 17 Saskatchewan cities and 149 towns. Returns current Tier A–D counts, evidence-domain coverage, public-model input counts, local-context status and the next defensible data action for each municipality.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_municipality_evidence_coverage",
"outputSchema": null
},
{
"description": "Housing market by community: median price, listings, market velocity, and the own-vs-rent monthly cost on the local wage. Pass municipalityId for one community with the price trend and full ownership model.",
"inputSchema": {
"properties": {
"municipalityId": {
"description": "Municipality id (e.g. saskatoon). Omit for all communities.",
"type": "string"
}
},
"type": "object"
},
"name": "get_real_estate",
"outputSchema": null
},
{
"description": "Measured rental markets (CMHC Rental Market Survey via Statistics Canada, real data): average rents by unit type (bachelor to 3+ bedroom) and rental vacancy rates for every surveyed centre in Canada, October survey. Pass province for one province’s centres, centre (cmhcCode) for one centre, neither for the national overview. Suppressed cells are null and unsurveyed centres absent — never zero.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"centre": {
"description": "CMHC/StatCan geography code (cmhcCode) from a previous get_rents call.",
"type": "string"
},
"province": {
"description": "SGC 2021 code or postal abbreviation (e.g. SK).",
"type": "string"
}
},
"type": "object"
},
"name": "get_rents",
"outputSchema": null
},
{
"description": "One occupation in full: market figures, entry requirements, working conditions, training programs, and per-community outcomes (net and discretionary monthly income at the median wage).",
"inputSchema": {
"properties": {
"id": {
"description": "Role id from list_roles.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_role",
"outputSchema": null
},
{
"description": "One sector: its occupations, provider-qualified postings by community, and notable employers.",
"inputSchema": {
"properties": {
"id": {
"description": "Sector id from list_sectors.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_sector",
"outputSchema": null
},
{
"description": "Resolve either a governed upstream source id or runtime provider id. Returns the matching source or categorized provider with its lineage; omit id for the upstream source registry.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "Optional registered source id from get_data_sources or provider id from get_data_providers.",
"type": "string"
}
},
"type": "object"
},
"name": "get_source_provenance",
"outputSchema": null
},
{
"description": "Saskatchewan merchandise exports by NAPCS section from Statistics Canada. Station-level CGC rows are excluded pending commercial redistribution permission.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_trade_overview",
"outputSchema": null
},
{
"description": "Retrieve wage evidence for an occupation and geography with units, period, source, confidence, and comparability qualifications.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"noc": {
"description": "Five-digit NOC 2021 unit-group code from list_noc_groups.",
"type": "string"
},
"province": {
"description": "SGC 2021 code, postal abbreviation (e.g. SK), or \"canada\".",
"type": "string"
}
},
"type": "object"
},
"name": "get_wage_evidence",
"outputSchema": null
},
{
"description": "Measured wages and vacancies (Statistics Canada, real data): LFS median/average hourly wages by occupation group × province, and JVWS job vacancies with average offered hourly wage by NOC 2021 unit group × province/territory. Pass noc for one unit group across geographies, province for one geography, both for one cell, neither for the national overview. Wage medians are group-level; each estimate names the published grouping that answered.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"noc": {
"description": "Five-digit NOC 2021 unit-group code from list_noc_groups.",
"type": "string"
},
"province": {
"description": "SGC 2021 code, postal abbreviation (e.g. SK), or \"canada\".",
"type": "string"
}
},
"type": "object"
},
"name": "get_wages",
"outputSchema": null
},
{
"description": "Grant a purpose-scoped consent on behalf of the sandbox business. This is what an invitation in the report is asking for. The classes are separate on purpose: granting one never widens another.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
},
"consentClass": {
"enum": [
"listing",
"operating_detail",
"aggregate_use",
"succession",
"capability_profile",
"purchasing_needs",
"professional_escalation"
],
"type": "string"
}
},
"required": [
"businessId",
"consentClass"
],
"type": "object"
},
"name": "grant_business_consent",
"outputSchema": null
},
{
"description": "What OEX has asked about a subject, what it could not conclude, why, and which registered question logically follows. Governed and deterministic: every field is a typed governed value or a fixed catalogue constant, no model is invoked, and nothing is derived from prose. This is not a work queue — it carries no identifiers to act on, and OEX accepts no report that a dependency was addressed. A dependency stops being reported when the same question, asked again against changed governed evidence, no longer derives it. Use investigate_economic_question or the subject’s own resource for the facts; this reports only what remains unresolved. Follow only nextInquiries; awaiting_evidence means stop until admissible evidence changes. evidenceRequirements names public question prerequisites without exposing private sources. Already evaluated questions are replaced by their blockers.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"subjectId": {
"description": "The canonical OEX identifier for the subject, such as a municipality slug.",
"maxLength": 200,
"type": "string"
},
"subjectKind": {
"description": "The kind of subject. Kinds any registered inquiry type asks about are listed in the response under admissibility.inquirableSubjectKinds.",
"type": "string"
}
},
"required": [
"subjectKind",
"subjectId"
],
"type": "object"
},
"name": "inspect_knowledge_frontier",
"outputSchema": null
},
{
"description": "Inspect official Saskatchewan CanadaBuys procurement observations by buyer, notice, or UNSPSC product/service category. Returns current and historical lifecycle evidence, amendments, conflicts, provenance, and explicit missing-evidence boundaries. It does not rank tenders, infer supplier fit, or expose private supplier/customer relationships.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"buyerId": {
"description": "Exact source-scoped organization id from resolve_entities.",
"type": "string"
},
"categoryCode": {
"description": "Exact eight-digit UNSPSC code from resolve_entities.",
"pattern": "^\\d{8}$",
"type": "string"
},
"includeHistory": {
"description": "Include closed historical demand observations; default true.",
"type": "boolean"
},
"limit": {
"description": "Maximum observations returned; default 100.",
"maximum": 500,
"minimum": 0,
"type": "integer"
},
"noticeId": {
"description": "Exact source-stable procurement-notice id.",
"type": "string"
}
},
"type": "object"
},
"name": "inspect_procurement_activity",
"outputSchema": null
},
{
"description": "Turn a natural-language economic question into an inspectable deterministic plan, resolve governed entities, execute a bounded set of existing OEX graph/data primitives, and return a citation-ready evidence bundle. OEX does not invoke a hosted model or generate a hidden reasoning chain; synthesize only from the returned evidence and limitations.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"depth": {
"description": "Maximum graph traversal depth; default 2.",
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"entities": {
"description": "Optional exact entity hints. Use these when a place, business, occupation, sector, signal, or source is not stated unambiguously in the question.",
"items": {
"additionalProperties": false,
"properties": {
"id": {
"maxLength": 200,
"type": "string"
},
"type": {
"enum": [
"occupation",
"municipality",
"geography",
"sector",
"training-program",
"noc-unit-group",
"data-source",
"data-provider",
"economic-region",
"census-division",
"trade-region",
"naics-industry",
"industrial-facility",
"open-source-signal",
"organization",
"project",
"procurement-notice",
"product-or-service",
"job-posting",
"employer",
"business-source-observation",
"establishment",
"business"
],
"type": "string"
}
},
"required": [
"type",
"id"
],
"type": "object"
},
"maxItems": 4,
"type": "array"
},
"maxEvidenceCalls": {
"description": "Maximum governed evidence calls executed; default 6.",
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"minimumConfidence": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
},
"question": {
"description": "The economic question. Do not include personal or confidential information.",
"maxLength": 1000,
"type": "string"
}
},
"required": [
"question"
],
"type": "object"
},
"name": "investigate_economic_question",
"outputSchema": null
},
{
"description": "List governed Saskatchewan economic signals from official structured sources. Each row preserves lifecycle state and uncertainty; notices do not prove an award, project, hiring or outcome.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Page size.",
"maximum": 1000,
"minimum": 0,
"type": "number"
},
"offset": {
"description": "Zero-based page offset.",
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"name": "list_economic_signals",
"outputSchema": null
},
{
"description": "What Business Health can actually inspect, fix, generate, verify and escalate — every check, what evidence it reads, what it needs before it will run, and what it offers as a fix. Read this before promising a business anything: it is the authoritative list of what OEX can do about a finding, and it distinguishes the checks that run for anyone from the ones that need a claim or a verified claim. Read-only, needs no account and no business, and answers even when the database is down.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_health_capabilities",
"outputSchema": null
},
{
"description": "The complete NOC 2021 occupational classification: all 516 unit groups with bilingual titles, TEER tiers, and platform coverage flags. Use to map any Canadian occupation to its code.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_noc_groups",
"outputSchema": null
},
{
"description": "The Saskatchewan occupation catalogue: id, title, NOC code, sector, hourly wage, demand score. Start here to find role ids.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_roles",
"outputSchema": null
},
{
"description": "List the sandbox businesses that exist, so you can resume working on one.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_sandbox_businesses",
"outputSchema": null
},
{
"description": "Sector rollups with provider-qualified hiring-record counts, median wage and occupation demand. Candidate profiles are excluded. Read meta.evidence before interpreting a count.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_sectors",
"outputSchema": null
},
{
"description": "Query the materialized semantic graph without downloading whole datasets. Resolve an entity name/code and optional municipality geography, then return typed facts and relationships. This supports municipality-by-NAICS GDP and business queries without encoding classifications in metric names. Missing facts or edges mean unknown, never zero or false.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"bundle": {
"description": "Bounded metric preset. municipal-economic-profile-v1 requires one municipality entity.",
"enum": [
"municipal-economic-profile-v1"
],
"type": "string"
},
"depth": {
"description": "Hops to expand outward from entity; default 1. Above 1 adds an expansion block of nodes and edges annotated with the hop that reached them, so a containment chain such as municipality -> census-division -> economic-region can be fetched in one call instead of three. Requires entity.",
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"entity": {
"description": "Exact name, slug, graph id, NOC code, SGC code, source id, or provider id.",
"type": "string"
},
"geography": {
"description": "Optional exact municipality name, slug, or SGC code for geography-scoped facts.",
"type": "string"
},
"limit": {
"description": "Maximum facts, relationships, or listed entities; default 25.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"maxNodes": {
"description": "Ceiling on entities across the whole expansion; default 200. Distinct from limit, which bounds one level — without it a depth of 2 from a municipality would pull every business in it.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"metrics": {
"description": "Fact metrics, e.g. population.",
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"minimumConfidence": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
},
"predicates": {
"description": "Relationship predicates, e.g. classified_as or serves.",
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"referencePeriodEnd": {
"description": "Inclusive ISO-8601 upper bound for fact reference periods.",
"type": "string"
},
"referencePeriodStart": {
"description": "Inclusive ISO-8601 lower bound for fact reference periods.",
"type": "string"
},
"truthStates": {
"items": {
"enum": [
"live",
"snapshot",
"measured_aggregate",
"derived",
"mixed",
"metadata",
"unavailable"
],
"type": "string"
},
"maxItems": 7,
"type": "array"
},
"type": {
"description": "Optional entity-type constraint.",
"enum": [
"occupation",
"municipality",
"geography",
"sector",
"training-program",
"noc-unit-group",
"data-source",
"data-provider",
"economic-region",
"census-division",
"trade-region",
"naics-industry",
"industrial-facility",
"open-source-signal",
"organization",
"project",
"procurement-notice",
"product-or-service",
"job-posting",
"employer",
"business-source-observation",
"establishment",
"business"
],
"type": "string"
}
},
"type": "object"
},
"name": "query_knowledge_graph",
"outputSchema": null
},
{
"description": "Rank Saskatchewan communities by monthly discretionary income for exactly one role or explicit hourly wage.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Number of ranked communities, 1-20 (default 10).",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"occupation": {
"description": "Role id whose median wage should be modelled.",
"type": "string"
},
"wage": {
"description": "Explicit positive hourly wage in CAD.",
"exclusiveMinimum": 0,
"type": "number"
}
},
"type": "object"
},
"name": "rank_communities",
"outputSchema": null
},
{
"description": "Ask OEX to look again — what a business does after fixing something. Inspects the website if one is supplied. Rate-limited, and a check that could not run is reported as unable-to-verify rather than as fixed.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
},
"checkId": {
"description": "Optional: recheck one finding rather than all.",
"type": "string"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "recheck_business_health",
"outputSchema": null
},
{
"description": "Record that the owner says a finding is fixed. This is their claim, not OEX's: nothing renders as resolved until a recheck runs and the check actually passes.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
},
"checkId": {
"type": "string"
}
},
"required": [
"businessId",
"checkId"
],
"type": "object"
},
"name": "report_health_action_complete",
"outputSchema": null
},
{
"description": "Resolve a public graph assertion citation to its canonical entity or entities, exact assertion, source, observation time, truth state, confidence, publication scope, methodology and provenance. Accepts the OEX citation URN, token, or resolver URL returned beside a graph fact or relationship.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"citation": {
"description": "citation.id, citation resolver URL, or versioned citation token.",
"type": "string"
}
},
"required": [
"citation"
],
"type": "object"
},
"name": "resolve_citation",
"outputSchema": null
},
{
"description": "Resolve a user-supplied name, slug, NOC code, SGC code, program, sector or governed source to its canonical OEX identity. Call this before joining datasets when the identifier is uncertain. Results include the correct follow-up MCP tool and arguments.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Maximum matches; default 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Name, alternate title, slug, or official identifier.",
"type": "string"
},
"type": {
"description": "Optional entity-type constraint.",
"enum": [
"occupation",
"municipality",
"geography",
"sector",
"training-program",
"noc-unit-group",
"data-source",
"data-provider",
"economic-region",
"census-division",
"trade-region",
"naics-industry",
"industrial-facility",
"open-source-signal",
"organization",
"project",
"procurement-notice",
"product-or-service",
"job-posting",
"employer",
"business-source-observation",
"establishment",
"business"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "resolve_entities",
"outputSchema": null
},
{
"description": "Resolve user language or an official code to the canonical OEX identity and the correct next tool. Returns ranked candidates when the input is ambiguous.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Maximum matches; default 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Name, alternate title, slug, or official identifier.",
"type": "string"
},
"type": {
"description": "Optional entity-type constraint.",
"enum": [
"occupation",
"municipality",
"geography",
"sector",
"training-program",
"noc-unit-group",
"data-source",
"data-provider",
"economic-region",
"census-division",
"trade-region",
"naics-industry",
"industrial-facility",
"open-source-signal",
"organization",
"project",
"procurement-notice",
"product-or-service",
"job-posting",
"employer",
"business-source-observation",
"establishment",
"business"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "resolve_entity",
"outputSchema": null
},
{
"description": "Run the Guided Business Study on a sandbox business: Business Health plus the three analytical instruments — Negative Space (what would be expected here and is not observed), Boundary Fracture (values that exist on one of the business’s own surfaces and never crossed to the other), and Strategic Node Finder (the one intervention that addresses several findings at once) — composed into one lineage-preserving result. Reads only the evidence OEX already holds; this tool never fetches the website. Every conclusion cites the evidence behind it, insufficient evidence returns explicit unknowns rather than guesses, and zero strategic nodes is a real answer.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
},
"inspectWebsite": {
"description": "Optional, default false. Inspect the website on record before running, so the stages that compare the site against the record can actually look. Costs one bounded fetch of the claimed domain; without it those stages honestly report that nothing was inspected.",
"type": "boolean"
},
"objective": {
"description": "Optional: what the business is trying to accomplish, in its own words. Carried into the study.",
"type": "string"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "run_business_study",
"outputSchema": null
},
{
"description": "The same Guided Business Study as a markdown document — the form a study is handed over in, with each stage’s findings beside its own evidence table.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
},
"inspectWebsite": {
"description": "Optional, default false. Inspect the website on record before running, so the stages comparing the site against the record can look. Costs one bounded fetch.",
"type": "boolean"
},
"objective": {
"description": "Optional: the business’s stated objective.",
"type": "string"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "run_business_study_markdown",
"outputSchema": null
},
{
"description": "Search governed municipal licensed-business snapshots without inferring operating health, employment, ownership, or hiring.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Rows to return, 1-200 (default 50).",
"type": "number"
},
"municipalityId": {
"description": "Municipality id. Only communities with a reviewed snapshot resolve.",
"type": "string"
},
"offset": {
"description": "Rows to skip for paging.",
"type": "number"
},
"q": {
"description": "Business-name contains match.",
"type": "string"
},
"subsector": {
"description": "Three-digit NAICS subsector code to filter by, e.g. 484.",
"type": "string"
}
},
"required": [
"municipalityId"
],
"type": "object"
},
"name": "search_businesses",
"outputSchema": null
},
{
"description": "Search the public business directory by name, municipality, sector group and observed hiring flag. Preview providers return modelled activity scenarios, not business claims.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"hiring": {
"description": "true to filter on the disclosed hiring flag; preview providers expose modelled scenarios.",
"type": "boolean"
},
"limit": {
"description": "Result limit, 1-100 (default 25).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"municipality": {
"description": "Municipality id from /api/v1/municipalities.",
"type": "string"
},
"q": {
"description": "Case-insensitive text search over employer and sector names.",
"type": "string"
},
"sector": {
"description": "Sector-group id from /api/v1/sectors.",
"type": "string"
}
},
"type": "object"
},
"name": "search_employers",
"outputSchema": null
},
{
"description": "Search across supported OEX entity classes using names, aliases, slugs, and official identifiers.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Maximum matches; default 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Name, alternate title, slug, or official identifier.",
"type": "string"
},
"type": {
"description": "Optional entity-type constraint.",
"enum": [
"occupation",
"municipality",
"geography",
"sector",
"training-program",
"noc-unit-group",
"data-source",
"data-provider",
"economic-region",
"census-division",
"trade-region",
"naics-industry",
"industrial-facility",
"open-source-signal",
"organization",
"project",
"procurement-notice",
"product-or-service",
"job-posting",
"employer",
"business-source-observation",
"establishment",
"business"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_entities",
"outputSchema": null
},
{
"description": "Source-attributed hiring-activity evidence, newest first and filterable by occupation, sector and geography. data.recordPurpose and each row recordPurpose are hiring_activity_evidence; rows are observations with isActionable=false, not jobs offered for application through OEX. Check observationDate, lastVerifiedAt, provenance, meta.evidence.truthState and synthetic before using a record as current evidence.",
"inputSchema": {
"properties": {
"limit": {
"description": "Page size, 1-200 (default 50).",
"type": "integer"
},
"minWage": {
"description": "Minimum hourly wage, CAD.",
"type": "number"
},
"municipality": {
"description": "Exact municipality name.",
"type": "string"
},
"occupation": {
"description": "Role id from the occupation catalogue.",
"type": "string"
},
"offset": {
"description": "Pagination offset (default 0).",
"type": "integer"
},
"postedWithinDays": {
"description": "Only postings newer than this many days.",
"type": "integer"
},
"q": {
"description": "Free-text search over title, employer and description.",
"type": "string"
},
"region": {
"description": "Exact region name.",
"type": "string"
},
"sector": {
"description": "Sector id from the sector list.",
"type": "string"
},
"type": {
"description": "Employment type.",
"enum": [
"full-time",
"part-time",
"seasonal",
"casual",
"contract"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_hiring_activity",
"outputSchema": null
},
{
"description": "Named businesses holding a municipal licence in one community, from an attributed City snapshot. Answers who exists and in which industry, NOT who is hiring — use search_employers for that. Each row is a licence held on the reference date: it is not a legal-entity register, not current beyond that date, incomplete for excluded licence categories, and not evidence of ownership, employment, size or operating health. Home-based licences carry no address.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"description": "Rows to return, 1-200 (default 50).",
"type": "number"
},
"municipalityId": {
"description": "Municipality id. Only communities with a reviewed snapshot resolve.",
"type": "string"
},
"offset": {
"description": "Rows to skip for paging.",
"type": "number"
},
"q": {
"description": "Business-name contains match.",
"type": "string"
},
"subsector": {
"description": "Three-digit NAICS subsector code to filter by, e.g. 484.",
"type": "string"
}
},
"required": [
"municipalityId"
],
"type": "object"
},
"name": "search_licensed_businesses",
"outputSchema": null
},
{
"description": "Tell OEX the business's website so it can be inspected. Supplying a domain permits inspection; it does not assert that the business owns or controls it, and OEX will not publish the domain as the business's own on this basis alone.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
},
"domain": {
"type": "string"
}
},
"required": [
"businessId",
"domain"
],
"type": "object"
},
"name": "set_website_domain",
"outputSchema": null
},
{
"description": "Record that work on a finding has begun — the owner opening the action. Moves the finding's action state, which is what makes its history readable later.",
"inputSchema": {
"properties": {
"businessId": {
"type": "string"
},
"checkId": {
"type": "string"
}
},
"required": [
"businessId",
"checkId"
],
"type": "object"
},
"name": "start_health_action",
"outputSchema": null
},
{
"description": "Aggregate hiring records associated with occupational credential requirements. Candidate profiles and holder counts are excluded; the result describes demand evidence, not a proven shortage.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "summarize_credential_demand",
"outputSchema": null
},
{
"description": "Traverse bounded, typed economic relationships from a resolved entity without treating missing edges as false.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"bundle": {
"description": "Bounded metric preset. municipal-economic-profile-v1 requires one municipality entity.",
"enum": [
"municipal-economic-profile-v1"
],
"type": "string"
},
"depth": {
"description": "Hops to expand outward from entity; default 1. Above 1 adds an expansion block of nodes and edges annotated with the hop that reached them, so a containment chain such as municipality -> census-division -> economic-region can be fetched in one call instead of three. Requires entity.",
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"entity": {
"description": "Exact name, slug, graph id, NOC code, SGC code, source id, or provider id.",
"type": "string"
},
"geography": {
"description": "Optional exact municipality name, slug, or SGC code for geography-scoped facts.",
"type": "string"
},
"limit": {
"description": "Maximum facts, relationships, or listed entities; default 25.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"maxNodes": {
"description": "Ceiling on entities across the whole expansion; default 200. Distinct from limit, which bounds one level — without it a depth of 2 from a municipality would pull every business in it.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"metrics": {
"description": "Fact metrics, e.g. population.",
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"minimumConfidence": {
"enum": [
"A",
"B",
"C",
"D"
],
"type": "string"
},
"predicates": {
"description": "Relationship predicates, e.g. classified_as or serves.",
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"referencePeriodEnd": {
"description": "Inclusive ISO-8601 upper bound for fact reference periods.",
"type": "string"
},
"referencePeriodStart": {
"description": "Inclusive ISO-8601 lower bound for fact reference periods.",
"type": "string"
},
"truthStates": {
"items": {
"enum": [
"live",
"snapshot",
"measured_aggregate",
"derived",
"mixed",
"metadata",
"unavailable"
],
"type": "string"
},
"maxItems": 7,
"type": "array"
},
"type": {
"description": "Optional entity-type constraint.",
"enum": [
"occupation",
"municipality",
"geography",
"sector",
"training-program",
"noc-unit-group",
"data-source",
"data-provider",
"economic-region",
"census-division",
"trade-region",
"naics-industry",
"industrial-facility",
"open-source-signal",
"organization",
"project",
"procurement-notice",
"product-or-service",
"job-posting",
"employer",
"business-source-observation",
"establishment",
"business"
],
"type": "string"
}
},
"type": "object"
},
"name": "traverse_relationships",
"outputSchema": null
},
{
"description": "Correct or complete the business's own record — the fix for most findings about missing or thin information. Supply only the fields you are changing; an omitted field is left alone, not cleared.",
"inputSchema": {
"properties": {
"address": {
"type": "string"
},
"businessId": {
"type": "string"
},
"category": {
"type": "string"
},
"description": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"type": "string"
}
},
"required": [
"businessId"
],
"type": "object"
},
"name": "update_business_record",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:429e16ba985a71bcc637eab0fed875b343ff4c3c575fad85475e904be171e9c2 | sha256sum