investigate_economic_question
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.
輸入參數depthentitiesquestion必填maxEvidenceCallsminimumConfidence
inspect_knowledge_frontier
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.
輸入參數subjectId必填subjectKind必填
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.
輸入參數typelimitquery必填
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.
輸入參數id必填type必填
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.
輸入參數typedepthlimitbundleentitymetricsmaxNodesgeographypredicatestruthStatesminimumConfidencereferencePeriodEnd另有 1 個
get_knowledge_graph_status
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.
無需輸入參數。
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.
輸入參數bundlemetricsentities必填
The Saskatchewan occupation catalogue: id, title, NOC code, sector, hourly wage, demand score. Start here to find role ids.
無需輸入參數。
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).
輸入參數id必填
Compare two or three roles using the shared occupation fields: wages, demand, outlook, entry requirements and work profile.
輸入參數ids必填
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.
輸入參數qtypelimitoffsetregionsectorminWageoccupationmunicipalitypostedWithinDays
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.
輸入參數wageoccupation
Rank Saskatchewan communities by monthly discretionary income for exactly one role or explicit hourly wage.
輸入參數wagelimitoccupation
Sector rollups with provider-qualified hiring-record counts, median wage and occupation demand. Candidate profiles are excluded. Read meta.evidence before interpreting a count.
無需輸入參數。
One sector: its occupations, provider-qualified postings by community, and notable employers.
輸入參數id必填
summarize_credential_demand
Aggregate hiring records associated with occupational credential requirements. Candidate profiles and holder counts are excluded; the result describes demand evidence, not a proven shortage.
無需輸入參數。
Search the public business directory by name, municipality, sector group and observed hiring flag. Preview providers return modelled activity scenarios, not business claims.
輸入參數qlimithiringsectormunicipality
Saskatchewan merchandise exports by NAPCS section from Statistics Canada. Station-level CGC rows are excluded pending commercial redistribution permission.
無需輸入參數。
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.
輸入參數municipalityId
search_licensed_businesses
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.
輸入參數qlimitoffsetsubsectormunicipalityId必填
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.
輸入參數nocprovince
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.
輸入參數centreprovince
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.
無需輸入參數。
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.
輸入參數limitcredentialslicenceClasshouseholdSizeincomeEarnerseducationLevelsavingsDollarsexperienceAreasbedroomsRequiredvehicleAvailabletargetOccupationIdmaximumRelocationKm另有 4 個
inspect_procurement_activity
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.
輸入參數limitbuyerIdnoticeIdcategoryCodeincludeHistory
assess_procurement_relevance
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.
輸入參數limitbusinessId必填includeHistory
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.
輸入參數limit
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.
輸入參數businessId必填
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.
輸入參數businessId必填
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.
輸入參數limitoffset
Get one governed economic signal by its source-stable id, including provenance, lifecycle state, mappings and uncertainty boundaries.
輸入參數id必填
Backward-compatible alias for list_economic_signals.
輸入參數limitoffset
Read the governed upstream source registry: publisher datasets, stable source ids, licence decisions, approved and excluded uses, checked releases, materialization bindings and refresh controls.
無需輸入參數。
Read runtime provider contracts grouped as evidence, preview, planned, first-party and derived. Only the evidence group is eligible to support factual claims.
無需輸入參數。
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.
輸入參數id
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.
輸入參數citation必填
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.
無需輸入參數。
get_municipality_evidence_coverage
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.
無需輸入參數。
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.
輸入參數typelimitquery必填
Retrieve one governed entity record with its evidence, provenance, canonical links, and permitted interpretation.
輸入參數id必填type必填
Search across supported OEX entity classes using names, aliases, slugs, and official identifiers.
輸入參數typelimitquery必填
Search governed municipal licensed-business snapshots without inferring operating health, employment, ownership, or hiring.
輸入參數qlimitoffsetsubsectormunicipalityId必填
Retrieve the governed context and evidence boundary for one business entity. Licence presence establishes snapshot presence only.
輸入參數id必填
Compare 2–10 Saskatchewan communities and return explicit missing-data and comparability results for every requested metric.
輸入參數bundlemetricsentities必填
Retrieve governed Saskatchewan labour-demand evidence while keeping advertised openings, statistical vacancies, live listings, and modelled sector allocations distinct.
無需輸入參數。
Retrieve wage evidence for an occupation and geography with units, period, source, confidence, and comparability qualifications.
輸入參數nocprovince
Traverse bounded, typed economic relationships from a resolved entity without treating missing edges as false.
輸入參數typedepthlimitbundleentitymetricsmaxNodesgeographypredicatestruthStatesminimumConfidencereferencePeriodEnd另有 1 個
Find entities connected through governed graph predicates, with source, truth state, confidence, and hop annotations.
輸入參數typedepthlimitbundleentitymetricsmaxNodesgeographypredicatestruthStatesminimumConfidencereferencePeriodEnd另有 1 個
Retrieve a governed upstream source or runtime provider and its lineage, licence boundary, releases, and serving status.
輸入參數id
Explain the OEX A–D record-confidence vocabulary, its weakest-input rule for derived values, and the interpretation contract.
輸入參數confidence
Explain what an OEX truth state permits an agent to claim and return the complete interpretation contract.
輸入參數truthState
Check whether requested community observations share compatible concepts, units, geographic boundaries, and reference periods; return explicit reasons where they do not.
輸入參數bundlemetricsentities必填
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.
輸入參數name必填phoneaddresswebsitecategorydescription
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.
輸入參數businessName
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.
無需輸入參數。
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.
輸入參數name必填phoneaddresscategorydescription
List the sandbox businesses that exist, so you can resume working on one.
無需輸入參數。
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.
輸入參數businessId必填
get_business_health_markdown
The same report as markdown — the form an owner would hand to whoever maintains their website.
輸入參數businessId必填
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.
輸入參數namephoneaddresscategorybusinessId必填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.
輸入參數businessId必填consentClass必填
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.
輸入參數domain必填businessId必填
Get an asset OEX generates from the business's own record: 'local-business-jsonld' or 'corrected-info-block'.
輸入參數assetId必填businessId必填
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.
輸入參數checkId必填businessId必填
report_health_action_complete
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.
輸入參數checkId必填businessId必填
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.
輸入參數checkIdbusinessId必填
get_health_action_history
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.
輸入參數checkIdbusinessId必填
check_opportunity_readiness
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.
輸入參數limitbusinessId必填
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.
輸入參數objectivebusinessId必填inspectWebsite
run_business_study_markdown
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.
輸入參數objectivebusinessId必填inspectWebsite