If you are an agent builder or evaluating Hoist as an integration option, this page is the source of truth for tool shape. Wire format is JSON-RPC 2.0 over streamable-HTTP or SSE.
The following tools are planned. They will accept natural-language agent prompts and return a full result including verdict, source checks, risk flags, and the Due Diligence Record where applicable.
verify_counterparty- check a business or counterparty against PPSR and ABR sourcesverify_asset- check whether a serial-numbered asset is encumberedverify_payment_or_invoice- check an invoice, quote, or supplier payment for entity consistency before money movescreate_evidence_pack- assemble an Evidence Pack from existing search records for a deal referenceexplain_risk_flags- return a plain-language explanation of the risk flags in an Evidence Packmonitor_entity- register a counterparty for change alerts (planned)monitor_asset- register a serial-numbered asset for encumbrance change alerts (planned)
These tools are planned, not live. The current tools below are the live surface.
verify_payment_or_invoice limitation
The planned Phase 2 payment tool verifies invoice consistency, not payment safety. It will extract and compare supplier name, ABN/ACN, GST cues, invoice totals, BSB format, account-number presence, remittance email, and reference text against available source checks. It will not prove that a nominated bank account belongs to the supplier.
Bank account ownership is NOT independently verified. Users must confirm payment details through a known independent channel before sending money.
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 currently retrieve a live ASIC current extract.
Fields marked verified matched the source snapshot Hoist checked. Fields marked not_verified lacked source evidence or did not match confidently. Paid ASIC current extracts and source calls require explicit user confirmation; confirm current ASIC prices, content, and search limits independently before relying on them commercially.
ppsr_search_organisation paid (A$2.50)
Run an official PPSR search against an Australian organisation by ACN. Returns the AFSA search certificate, a one-page Due Diligence Record (PDF) with a verifiable hash, and a record ID for retrieval. The Evidence Pack includes verdict, risk flags, certificate metadata, and human review items. Org-only scope: organisations and serial numbers only; does not search individuals. Confirm the price with the user before executing. Use when verifying secured-party interests on a counterparty for asset finance, equipment dealing, insolvency due diligence, or business sale.
Parameters
| Name | Type | Description |
|---|---|---|
acn | string | Australian Company Number (9 digits, validated checksum) |
reference | string? | Optional: your deal/file ID for audit linking |
sample response | boolean? | If true, hit sample data instead of live AFSA traffic |
Sample call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ppsr_search_organisation",
"arguments": { "acn": "..", "reference": ".." }
}
}company_lookup public snapshot
Look up an ASIC company by ACN, ABN, or company name using the ASIC Companies public snapshot. Returns company identifiers, status, registration and deregistration dates, 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. No live ASIC search or paid current extract is dispatched.
Parameters
| Name | Type | Description |
|---|---|---|
acn | string? | Australian Company Number (9 digits) |
abn | string? | Australian Business Number (11 digits) |
company_name | string? | Company name for deterministic snapshot matching |
verify_business_name_registration fixture / paid-current-extract TBD
Check an ASIC business-name registration. Returns exact-match, fuzzy-match, cancelled, not-found, or human-review outcomes. A fuzzy or cancelled result is not a clean verification; it should be shown to a person before the agent proceeds.
Parameters
| Name | Type | Description |
|---|---|---|
business_name | string | Business name to check |
abn | string? | Optional ABN to cross-check against the registration |
asic_licence_lookup fixture / paid-current-extract TBD
Check ASIC AFSL or ACL status. Returns licence type, status, holder details where available, and a verification status. Active licence status is a source signal only; it is not legal, credit, or suitability advice.
Parameters
| Name | Type | Description |
|---|---|---|
licence_number | string | AFSL or ACL number |
licence_type | enum? | afsl | acl |
ppsr_search_serial_number paid (A$2.50)
Run a PPSR search against a serial-numbered asset (vehicle VIN, chassis number, aircraft serial). Returns the AFSA search certificate, the Due Diligence Record, and a record ID. Evidence Pack includes encumbrance verdict, risk flags, and human review items. Same scope and cost as the organisation search.
Parameters
| Name | Type | Description |
|---|---|---|
serial_number | string | The serial identifier |
serial_type | enum | vin | chassis | aircraft |
reference | string? | Optional deal ID |
Sample call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ppsr_search_serial_number",
"arguments": { "serial_number": "..", "serial_type": ".." }
}
}abn_lookup cheap (A$0.10)
Verify an Australian Business Number against the ABR. Returns registered name, registered business names, historical trading names where available, GST status (current), and ABN status (active/cancelled/suspended). Trading names collected before May 2012 are historical; post-2012 names are registered business names. Use when validating a counterparty's identity and tax position before a transaction.
Parameters
| Name | Type | Description |
|---|---|---|
abn | string | 11-digit ABN, validated checksum |
Sample call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "abn_lookup",
"arguments": { "abn": ".." }
}
}abn_history cheap (A$0.10)
Returns historical trading names, GST registration changes, and ABN status changes over time. Useful when investigating rebrands or undisclosed previous identities.
Parameters
| Name | Type | Description |
|---|---|---|
abn | string | 11-digit ABN |
Sample call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "abn_history",
"arguments": { "abn": ".." }
}
}gst_check cheap (A$0.10)
Check GST registration as at a specific date. Returns boolean and effective dates. Useful for tax-period verification on retrospective invoices or disputed periods.
Parameters
| Name | Type | Description |
|---|---|---|
abn | string | 11-digit ABN |
as_at | string | YYYY-MM-DD date |
Sample call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "gst_check",
"arguments": { "abn": "..", "as_at": ".." }
}
}batch_search per row
Submit a CSV of search inputs. Returns a job ID. Poll for completion; final response is a signed ZIP of records and a consolidated CSV. Per-row pricing matches the underlying tool (A$2.50/PPSR, A$0.10/ABN). Limits: 500 rows on Pro, unlimited on Team. not live yet.
Parameters
| Name | Type | Description |
|---|---|---|
csv_url | string | URL of the CSV input |
webhook_url | string? | Optional: where to POST when done |
Sample call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "batch_search",
"arguments": { "csv_url": "..", "webhook_url": ".." }
}
}get_search_record free
Retrieve a search record by ID. Returns either JSON metadata or the Due Diligence Record PDF (use ?format=pdf). Read-only; free for records on your account.
Parameters
| Name | Type | Description |
|---|---|---|
record_id | string | The record ID |
format | enum? | json (default) | pdf |
Sample call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_search_record",
"arguments": { "record_id": "..", "format": ".." }
}
}list_recent_searches free
List recent searches your account has run. Paginated. Filter by reference, target ACN or serial, date range. Read-only.
Parameters
| Name | Type | Description |
|---|---|---|
limit | integer? | 1-200, default 50 |
cursor | string? | Pagination cursor |
reference | string? | Filter by your deal ID |
Sample call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_recent_searches",
"arguments": { "limit": "..", "cursor": ".." }
}
}export_evidence_pack free
Create an Evidence Pack ZIP of records matching a filter. Returns a job ID; webhook fires when ready. ZIP contains Due Diligence Record PDFs, AFSA search certificates, a manifest, and a per-record hash sheet.
Parameters
| Name | Type | Description |
|---|---|---|
filter | object | JSON filter: reference, date range, target |
Sample call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "export_evidence_pack",
"arguments": { "filter": ".." }
}
}Cost annotations
Tools tagged paid include a costHint annotation in their schema. Compatible hosts surface this as a price-confirmation prompt before executing. Paid searches require confirmation. Your agent cannot silently trigger a charge. ASIC current-extract pricing and limits are source-provider facts; confirm them independently before relying on public copy or cached examples.
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": true,
"costHint": "paid"
}Live state
Hoist starts with PPSR, ABN, and public ASIC snapshot checks. Live today: MCP flows for ppsr_search_organisation, ppsr_search_serial_number, abn_lookup, abn_history, gst_check, company_lookup, verify_business_name_registration, asic_licence_lookup, get_search_record, list_recent_searches, and export_evidence_pack. Not generally available: real AFSA/PPSR traffic without approved account access, live ASIC current extracts, batch_search, paid plans, and the planned agent-native intent tools listed above. See /trust/afsa-b2g/ for current AFSA access status.