New ABN and GST lookups are live alongside PPSR. Read docs
Hoist AIAssets
Sign in / Sign up
Home›Docs›MCP›Install›Codex Cli

Install Hoist Assets in Codex CLI.

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

~/.codex/config.tomlOAuth setup

About the Hoist Connector

Hoist connects your AI tool of choice to Australian source data. Ask whether a business, asset, invoice, or counterparty checks out. Hoist checks the sources and returns an Evidence Pack: verdict, source checks, timestamps, risk flags, and next steps. The Due Diligence Record PDF is included where a search produces one.

Hoist works across MCP hosts, API clients, and CLI workflows. This guide covers Codex CLI. Use MCP for OAuth-approved agent-host access; use API or CLI when you control the API-key call path.

Current status. MCP discovery, OAuth metadata, dynamic client registration, and the protected MCP endpoint are live. Tool calls require OAuth. Real PPSR and ABN source checks require approved account access and source readiness. The REST API health endpoint is live; direct API and CLI calls use Hoist Assets API keys.

The config

[mcp_servers.hoist_assets]
command = "npx"
args = ["-y", "@hoist-assets/mcp"]

Steps

  1. Install Codex CLI: npm i -g @openai/codex.
  2. Add the snippet to ~/.codex/config.toml. Codex spawns the MCP server as a subprocess via npx.
  3. Run: codex --mcp hoist_assets. First run prompts you to approve OAuth in a browser.

Smoke test

In a Codex session: "Run a PPSR search on ACN 123 456 789." Codex routes to hoist-assets and confirms the price before executing.

Troubleshooting

  • OAuth window doesn't open. Check your default browser is set and pop-ups aren't blocked. On macOS you may need to allow Codex CLI accessibility permissions.
  • Tools don't appear after install. Restart the host completely. Some hosts cache the tool list at startup.
  • 403 on calls. Re-approve OAuth - the cached token may have expired or had scopes revoked.
  • Still stuck? Contact us with the host name and the error message.

What to ask after install

Once connected, try these in a Codex CLI session:

  • "Can we finance this vehicle for this ABN?" (runs abn_lookup + ppsr_search_serial_number)
  • "Is this asset encumbered?" (runs ppsr_search_serial_number or ppsr_search_organisation)
  • "Does this business have current GST registration?" (runs gst_check)
  • "Is this broker licensed?" (runs abn_lookup with trading-name history)
  • "What changed since we last checked this counterparty?" (runs abn_history)
  • "Export the Evidence Pack for deal reference AU-2026-0042." (runs export_evidence_pack)

Hoist returns source-backed evidence. It does not guarantee that a transaction is safe, legal, compliant, or financeable. Paid searches require confirmation before executing.

Other hosts