MCP tool reference

This page documents the tool surface exposed at:

MCPhttps://mcp.assets.hoistai.com/mcp

Wire format is JSON-RPC 2.0 over Streamable HTTP. Protected calls require OAuth consent and the matching scope. Available entries below mirror live discovery. The ppsr_search, lookup_address, company_lookup, and verify_business_name_registration sections are retained only as unavailable contract references; all four are hidden from tools/list until their release proof exists.

PPSR boundary.The ppsr_search schema includes preview and explicit-confirmation mechanics and carries a non-read-only annotation, but neither preview nor paid search is currently customer-accessible. Preview requests fail closed without a price or register dispatch. Paid PPSR searches and pricing are not currently available through Hoist.

Start with available tools.For a natural-language counterparty or invoice question, use verify_counterparty or verify_payment_or_invoice. The legacy create_evidence_pack path creates only a prelaunch sample/contract export; it does not query ABR, GST, VIN, or PPSR. Use abn_lookup when you already have an ABN. Do not invoke ppsr_search: it is hidden from discovery and unavailable until launch proof exists.

Counterparty and asset verification

`verify_counterparty`

Use this first for broader natural-language Australian company or counterparty questions involving available business identity, GST, selected released public-register data, risk flags, and cross-source consistency. It resolves business_name to an ABN where possible and returns a compact Evidence Card with a verdict, risk flags, per-source rows, and explicit unavailable boundaries. It does not return ASIC Companies, ASIC Business Names, ASIC AFS, DFAT sanctions, or PPSR evidence while those paths are launch-quarantined. Current callable identifiers are abn or business_name; direct acn input is reserved and returns an explicit unavailable error. address, email_domain, and phone are optional context. Not for ABN-only asks — use abn_lookup for those.

`ppsr_search`

The ppsr_search schema documents future organisation (ACN) and serial-number (VIN / motor vehicle / aircraft / watercraft) contracts. It is hidden from tools/list until launch proof exists. Neither op="preview" nor op="search" is customer-accessible: current calls fail closed, preview returns no quote, and neither operation hits the register. OAuth, a scope, account access, or a plan does not unlock the tool. This section is contract reference only, not invocation guidance.

`verify_payment_or_invoice`

Extract and sanity-check payment or invoice details from flat fields or untrusted invoice text. Organisation fields are parsed and normalised but are not matched to ABR, ASIC, or another identity source by this tool; call verify_counterparty separately. Returns a needs-review card, GST arithmetic and consistency signals, the account-control disclaimer, and an explicit PPSR-unavailable risk flag when asset identifiers are present. It never returns a PPSR price-confirmation action or dispatches a paid search.

`verify_professional`

Verify a person against the applicable released ASIC public register for the selected kind — financial_adviser, banned_disqualified_person, liquidator, credit_representative, registered_auditor, or smsf_auditor. Returns a summary-first answer card and a table containing only the applicable data source checked. The afs_representative input remains a contract reference but currently fails closed with source_unavailable while its combined ingest path is launch-quarantined.

Business identity

`abn_lookup`

Look up an Australian Business Number against the Australian Business Register. Returns the entity name, type, status, and registered-address summary. Use for ABN-only or ABR-only asks such as entity name, ABN status, and entity type. Org-only — never searches individuals. Free, no per-call cost.

`company_lookup`

Currently unavailable and omitted from tools/list while the multi-million-row production ingest path remains launch-quarantined. The future contract accepts exactly one identifier: checksum-valid ACN, checksum-valid ABN, or a 1-200 character exact normalised company name. Direct stale calls fail closed with source_unavailable; no completed, legacy, fixture, or merely registered snapshot row becomes customer evidence.

`verify_business_name_registration`

Currently unavailable and omitted from tools/list while the multi-million-row production ingest path remains launch-quarantined. The future contract accepts a 3-200 character exact deterministic normalised-name match, optionally constrained by a checksum-valid ABN. Direct stale calls fail closed with source_unavailable; no completed, legacy, fixture, or merely registered snapshot row becomes customer evidence.

`asic_licence_lookup`

Look up an ASIC AFSL or Australian Credit Licence status from explicit fixture data. Returns plain_english_answer, source_citation, source_url, source_reference, data_mode: fixture, and a snapshot date. This is not a live ASIC result. Hoist has no wired current-extract provider and offers no current-extract price or confirmation workflow; use the ASIC Professional Registers directly for current information.

`lookup_address`

Currently unavailable and omitted from MCP discovery. Hoist has not yet proven a complete server-owned G-NAF snapshot; the current adapter contains representative fixtures only. Direct stale calls fail closed with source_unavailable, and no fixture row, G-NAF PID, confidence score, or official-source citation is returned as customer evidence. The schema is a future contract reference, not invocation guidance.

Evidence packs and risk

`create_evidence_pack`

Create a prelaunch sample/contract Evidence Pack export. Every ABR, GST, VIN, and PPSR row produced by this tool is fixture or unsearched data: the tool does not verify an ABN, GST status, vehicle, asset, or counterparty and does not return a live PPSR result, price, clearance, or AFSA certificate. Returns the pack ID and a download URL. Writes an export — not a safe-to-auto-run read.

`create_due_diligence_pack`

Assemble an explicitly fixture-only due-diligence sample pack. Counterparty and asset fields shape sample slices only: this tool does not run ABR, GST, or PPSR as current source evidence; does not return registrations, clear an asset, or produce a certificate; and does not persist a shareable URL or completed PPSR receipt. Paid-search and confirmation flags are deprecated and ignored. Shapes a sample contract; not a source-backed export.

`create_asset_finance_evidence_pack`

Legacy alias for create_evidence_pack. Creates the same prelaunch sample/contract export: every ABR, GST, VIN, and PPSR row is fixture or unsearched. It does not verify a business or asset or return a live result, price, certificate, or clearance. Writes a sample export.

`explain_risk_flags`

Translate caller-supplied risk-flag codes into conditional, plain-English template meanings tailored to the reader’s role (broker / borrower / operator). The tool does not dereference the optional pack reference, query a source, or verify that any code is true. Its response is partial, has no source freshness or confidence, and labels the codes as unverified caller input. Pass codes as a CSV string via risk_flag_ids_csv.

`check_verification_policy`

Compare caller-supplied JSON with a workflow verification-policy template. The tool does not dereference a pack, receipt, snapshot, or source record. Caller rows therefore cannot satisfy or fail a rule: the result remains missing_evidence or needs_review until current server-owned provenance or independently reviewed official evidence exists.

Unavailable entity and asset monitoring contracts

`monitor_entity_or_asset`

Currently unavailable and omitted from MCP discovery. Hoist does not yet have an operational server-owned source fetcher and queued consumer for entity or asset subscriptions. It does not create active or pending subscriptions, schedule automatic rechecks, or send alerts.

`confirm_no_changes`

Currently unavailable and omitted from MCP discovery. Caller-supplied current evidence cannot prove that an upstream source did not change; no source recheck or comparison runs.

`what_changed`

Currently unavailable and omitted from MCP discovery. Caller-supplied snapshots do not establish a source-backed change; no entity or asset diff, automatic recheck, or alert runs.

`record_decision_memory`

Record or list append-only reviewer-outcome events for Evidence Packs, risk flags, policies, source assertions, and source matches. Events are always scoped to the authenticated caller — both record and list operate only on the caller’s own decision memory.

Opportunity intelligence

`find_opportunities`

Find official-source tenders, grants, forecasts, and RFI-style opportunities that match a business profile. Returns award and incumbent context when available.

`brief_opportunity`

Brief one official-source opportunity with key facts, award history, incumbent posture, risks, gaps, files metadata, and evidence URLs.

`find_incumbent`

Resolve incumbent and award-history posture for a buyer/funder and category/program from official award evidence.

`run_opportunity_monitor`

Produce an on-demand, read-only opportunity delta report for a business profile, including new, changed, urgent, and next-action items. It runs only when requested and does not create a subscription, schedule automatic rechecks, or send alerts.

Account and receipts

`show_due_diligence_receipt`

Display audit records for supported completed checks on the caller’s account. The schema can represent historical or future PPSR events, but no current Hoist PPSR preview or paid-search event is available. PII-free; no raw query payloads. This is not the assistant’s own tool-call access log — use show_trust_receipt for that.

`show_trust_receipt`

Display the assistant’s own access log — every available tool call it has made on your account, newest first. This is separate from source-check receipts. PPSR is currently unavailable and should not appear as a current successful call.

`revoke_assistant_access`

Disconnect this assistant from Hoist: permanently revoke this assistant’s OAuth grant and all its tokens. Takes effect immediately; the user must re-authorise to reconnect. No inputs required. Destructive and irreversible.

Payment and invoice limitation

verify_payment_or_invoice is an invoice-consistency workflow. It parses supplier name, ABN or ACN, account details, remittance email, and reference text and checks GST arithmetic and identifier consistency. It does not match organisation identity to ABR, ASIC, or another official source; use verify_counterparty separately. A completed ingested AusPayNet snapshot can resolve BSB directory details, while the bundled representative fallback is labelled partial and is never verified evidence. Neither path proves that a nominated bank account belongs to the supplier. Confirm payment details through a known independent channel before sending money.

ASIC current-extract limitation

ASIC company and business-name tools use completed public snapshots when available. The AFSL/ACL lookup is fixture-only. Hoist has no wired current-extract provider and does not expose a current-extract price, confirmation state, or dispatch path. Treat fixture and snapshot fields as historical context, not current ASIC evidence, and use the relevant official ASIC register directly before relying on a result.

Response fields

Tool results are structured for an agent to explain what it found and how current it is. Recurring fields across the source tools:

Field	What it tells you
`plain_english_answer`	A summary-first answer the agent can read back to the user.
`data_mode`	Whether the result came from live source traffic or a stored source snapshot.
`source_citation` / `source_url`	The authoritative source checked and a visible citation URL for human review.
`retrieved_at`	When the underlying source data was retrieved, so freshness is explicit.
`confidence` / risk flags	Confidence signal plus any mismatch or human-review flags.

Cost annotations

The future paid-search request shape sets readOnlyHint: false (and, where relevant, openWorldHint: true) and models explicit cost confirmation. These contract mechanics do not establish or unlock current production availability. The tool is hidden from discovery and fails closed; no price, confirmation action, provider call, billing action, certificate, or audit event is produced.

{
  "annotations": {
    "readOnlyHint": false,
    "openWorldHint": true
  }
}

Live-state summary

Hoist starts with available ABN and public-register checks. ASIC company and business-name lookups require completed server-owned snapshots and fail closed if those snapshots are unavailable. G-NAF address lookup is hidden and unavailable until a complete server-owned snapshot is proven. PPSR preview and explicit-confirmation mechanics are implemented but not currently customer-accessible; preview requests fail closed without a price or register dispatch. Paid PPSR searches and pricing are not currently available through Hoist. The legacy Evidence Pack exporter writes only fixture/unsearched sample artifacts; account access controls artifact writing but does not turn those rows into source-backed evidence or unlock PPSR.