Hoist AIAssets Sign in
HomeDocsMCPTools

MCP tools — full reference.

Rendered tools/list. Each entry shows the description an LLM reads when deciding whether to call the tool, plus parameters and sample calls. Endpoint: https://mcp.assets.hoistai.com.

9 toolsLast updated 2026-05-15

If you're an MCP host author or evaluating us 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.

ppsr_search_organisation paid (A$2.50)

Run an official AFSA PPSR search against an Australian organisation by ACN. Returns the AFSA certificate, a one-page Due Diligence Record (PDF) with a verifiable hash, and a record ID for retrieval. 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

NameTypeDescription
acnstringAustralian Company Number (9 digits, validated checksum)
referencestring?Optional: your deal/file ID for audit linking
sandboxboolean?If true, hit fixtures instead of AFSA

Sample call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ppsr_search_organisation",
    "arguments": { "acn": "...", "reference": "..." }
  }
}

ppsr_search_serial_number paid (A$2.50)

Run an AFSA PPSR search against a serial-numbered asset (vehicle VIN, chassis number, aircraft serial). Returns the certificate, the Due Diligence Record, and a record ID. Same scope and cost as the organisation search.

Parameters

NameTypeDescription
serial_numberstringThe serial identifier
serial_typeenumvin | chassis | aircraft
referencestring?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, current trading names, GST status (current), ABN status (active/cancelled/suspended). Use when validating a counterparty's identity and tax position before a transaction.

Parameters

NameTypeDescription
abnstring11-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 hidden previous identities.

Parameters

NameTypeDescription
abnstring11-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 + effective dates. Useful for tax-period verification on retrospective invoices or disputed periods.

Parameters

NameTypeDescription
abnstring11-digit ABN
as_atstringYYYY-MM-DD date

Sample call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "gst_check",
    "arguments": { "abn": "...", "as_at": "..." }
  }
}

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.

Parameters

NameTypeDescription
csv_urlstringURL of the CSV input
webhook_urlstring?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 PDF (use ?format=pdf). Read-only; free for records on your account.

Parameters

NameTypeDescription
record_idstringThe record ID
formatenum?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/serial, date range. Read-only.

Parameters

NameTypeDescription
limitinteger?1-200, default 50
cursorstring?Pagination cursor
referencestring?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 record PDFs, AFSA certificates, a manifest, and a per-record hash sheet.

Parameters

NameTypeDescription
filterobjectJSON 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 (Claude Desktop, ChatGPT, Cursor) surface this as a native price-confirmation card before executing.

"annotations": {
  "readOnlyHint": false,
  "destructiveHint": false,
  "openWorldHint": true,
  "costHint": "paid"
}