Home›Docs›MCP server

An MCP server for the Australian PPSR.

Tools for organisation and serial-number PPSR search, ABN/GST lookup, batch CSV, and record retrieval — all OAuth-scoped, price-confirmed, and described so any LLM can route correctly.

Endpoint mcp.assets.hoistai.comLiveLast updated 2026-05-15

One-line install

npx @hoist-assets/mcp init

Detects which MCP host(s) you have installed and writes the right config for each. Or pick a host below and follow the manual steps.

Install per host

MCP host

Claude Desktop

Anthropic's macOS/Windows desktop app. The most-installed MCP host.

Install MCP host

Claude.ai (web)

Browser Claude. MCP via custom connectors.

Install MCP host

ChatGPT

OpenAI's consumer client. MCP via Connectors (Pro/Business/Enterprise/Edu).

Install MCP host

Cursor

AI-first code editor. Reads `~/.cursor/mcp.json`.

Install MCP host

Cline

VS Code agent extension. Reads `mcp_settings.json`.

Install MCP host

Codex CLI

OpenAI's CLI coding agent. Reads `~/.codex/config.toml`.

Install MCP host

Gemini CLI

Google's CLI agent. Reads `~/.gemini/settings.json`.

Install MCP host

curl / direct HTTP

No MCP host — just hit the REST API. The baseline.

Install

Tools the server exposes

Tool	Cost hint	What it does
`ppsr_search_organisation`	paid (A$2.50)	AFSA PPSR search by ACN. Returns certificate + record.
`ppsr_search_serial_number`	paid (A$2.50)	AFSA PPSR search by VIN / chassis / aircraft serial.
`abn_lookup`	cheap (A$0.10)	Verify ABN, GST status, trading name (current).
`abn_history`	cheap (A$0.10)	Trading-name history, GST changes over time.
`gst_check`	cheap (A$0.10)	GST registration as at a specific date.
`batch_search`	per row	CSV in → ZIP out for portfolio review.
`get_search_record`	free	Retrieve a record (PDF or JSON) by ID.
`list_recent_searches`	free	Paginated list of recent searches.
`export_evidence_pack`	free	ZIP of records + certificates + audit log for a deal reference.

Tools tagged paid post a price confirmation to the host before executing. Compatible hosts (Claude Desktop, ChatGPT, Cursor) surface this as a native "confirm A$2.50 charge" prompt.

OAuth scopes

search:read — list and retrieve records you've already created. Read-only.
search:write — run paid PPSR and ABN searches. Required for the ppsr_* and abn_* tools.
batch:write — kick off CSV batches. Implies search:write.
exports:write — generate evidence-pack ZIPs.
billing:read — read usage & remaining allowance.

Discovery

The MCP discovery JSON lives at /.well-known/mcp.json and is advertised via <link rel="alternate" type="application/json"> on every page. AI agents crawling the site can discover the endpoint without parsing prose.

Authoring tools for our team

The MCP server source is open at github.com/HoistAiorg/hoist-assets-mcp. PRs welcome.