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 or SSE, depending on the host. Protected calls require OAuth consent and the matching scope.

Paid-search boundary.Tools with a cost annotation must be confirmed before execution. An agent cannot silently trigger a billable register search.

Agent-facing intent layer

These names describe higher-level workflow intents an agent may present to a user. Do not call them unless they appear in MCP discovery; use the live tool list below as the callable surface.

• verify_counterparty
• verify_asset
• verify_payment_or_invoice
• create_evidence_pack
• explain_risk_flags
• monitor_entity
• monitor_asset

Payment and invoice limitation

verify_payment_or_invoice is an invoice-consistency workflow. It checks supplier name, ABN or ACN, GST cues, invoice totals, BSB format, account-number presence, remittance email, and reference text against available source checks. It does not prove 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, business-name, AFSL, and ACL tools expose entity-intelligence checks. Public docs must not be read as a claim that Hoist has purchased or can retrieve a live ASIC current extract for every request. Fields marked verified matched the source snapshot Hoist checked. Fields marked not_verified need human review or independent confirmation.

PPSR tools

ppsr_search_organisation

Runs a PPSR search against an Australian organisation by ACN. Returns the AFSA search certificate, a Due Diligence Record where available, and a record ID for retrieval. Org-only scope: organisations and serial numbers only; not individuals.

Parameters:

Name	Type	Description
acn	string	Australian Company Number, 9 digits with checksum validation.
reference	string?	Optional deal or file ID for audit linking.
sample_response	boolean?	Use sample data where the account or source path requires it.

sample tool call

{
  "name": "ppsr_search_organisation",
  "arguments": {
    "acn": "123456789",
    "reference": "AU-2026-0042"
  }
}

ppsr_search_serial_number

Runs a PPSR search against a serial-numbered asset such as a vehicle VIN, chassis number, or aircraft serial.

Parameters:

Name	Type	Description
serial_number	string	The serial identifier.
serial_type	enum	vin, chassis, or aircraft.
reference	string?	Optional deal ID.
sample_response	boolean?	Use sample data where the account or source path requires it.

sample tool call

{
  "name": "ppsr_search_serial_number",
  "arguments": {
    "serial_number": "6T1BF3FK10X123456",
    "serial_type": "vin",
    "reference": "asset-file-17"
  }
}

ABN and GST tools

abn_lookup

Verifies an Australian Business Number against ABR-backed data. Returns registered name, registered business names where available, historical trading names where available, ABN status, and GST status. Trading names collected before May 2012 are historical; post-2012 names are registered business names.

Name	Type	Description
abn	string	11-digit ABN with checksum validation.

sample tool call

{
  "name": "abn_lookup",
  "arguments": {
    "abn": "11695718659"
  }
}

abn_history

Returns historical trading names where available, GST registration changes, and ABN status changes.

Name	Type	Description
abn	string	11-digit ABN.

gst_check

Checks GST registration as at a specific date.

Name	Type	Description
abn	string	11-digit ABN.
as_at	string	Date in YYYY-MM-DD format.

ASIC entity-intelligence tools

company_lookup

Looks up a company by ACN, ABN, or company name using the ASIC Companies public snapshot. Returns identifiers, company status, source timestamp, and field-level status labels such as verified, not_verified, and human_review_required. The public snapshot does not include directors, officeholders, shareholders, registered office, or ultimate holding company details.

Name	Type	Description
acn	string?	Australian Company Number.
abn	string?	Australian Business Number.
company_name	string?	Company name for deterministic snapshot matching.

verify_business_name_registration

Checks an ASIC business-name registration. Returns exact-match, fuzzy-match, cancelled, not-found, or human-review outcomes.

Name	Type	Description
business_name	string	Business name to check.
abn	string?	Optional ABN to cross-check against the registration.

asic_licence_lookup

Checks ASIC AFSL or ACL status. Active licence status is a source signal only; it is not legal, credit, or suitability advice.

Name	Type	Description
licence_number	string	AFSL or ACL number.
licence_type	enum?	afsl or acl.

Records and export tools

get_search_record

Retrieves a search record by ID. Returns JSON metadata or a Due Diligence Record PDF when available.

Name	Type	Description
record_id	string	The record ID.
format	enum?	json by default, or pdf.

list_recent_searches

Lists recent searches your account has run. Results are paginated and can be filtered by reference, target, and date range.

Name	Type	Description
limit	integer?	1-200, default 50.
cursor	string?	Pagination cursor.
reference	string?	Filter by your deal ID.

export_evidence_pack

Creates an Evidence Pack ZIP of records matching a filter. The ZIP contains Due Diligence Record PDFs where available, source certificates where available, a manifest, and per-record hashes.

Name	Type	Description
filter	object	JSON filter: reference, date range, target, or record IDs.

Batch tool

batch_search

Submits a CSV of search inputs and returns a job ID. Poll for completion or use a webhook URL. Per-row pricing follows the underlying tool family and account configuration.

Name	Type	Description
csv_url	string	URL of the CSV input.
webhook_url	string?	Optional completion callback.

Cost annotations

Tools that can dispatch paid searches include a costHint annotation in their schema. Compatible hosts surface this as a price-confirmation prompt before executing.

cost annotation shape

{
  "annotations": {
    "costHint": {
      "currency": "AUD",
      "requiresConfirmation": true
    }
  }
}

Live-state summary

Hoist starts with PPSR and ABN checks. Real source traffic, sample responses, record retrieval, and Evidence Pack export are controlled by account access, source readiness, scope, and billing capacity.