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

MCP setup for AI clients.

Connect Claude, ChatGPT, Cursor, Cline, Codex CLI, Gemini CLI, or a custom MCP client to Australian data. Hoist handles OAuth consent and scoped access.

Endpoint https://mcp.assets.hoistai.com/mcpOAuth consentPPSR + ABN first
No separate product per tool. Use API for direct HTTP, MCP for AI clients, and CLI for terminal work. The data and account controls are the same.

Endpoint

https://mcp.assets.hoistai.com/mcp

Use this exact URL in MCP-compatible hosts. It is the remote MCP server for Hoist.

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/source access. The REST API health endpoint is live; direct API and CLI calls use Hoist Assets API keys.

Authentication

MCP uses OAuth. The host registers a client, opens a browser, and asks the user to approve scopes. After approval, the host stores a scoped access token and sends it with MCP requests. Do not use HOIST_ASSETS_API_KEY for MCP.

  1. The AI host discovers Hoist at /.well-known/mcp.json.
  2. The host starts OAuth with PKCE.
  3. The user signs in and approves the requested scopes.
  4. The host receives a token scoped to that client.
  5. The user can revoke access from account settings.

Scopes

ScopeAllows
ppsr:search.orgRun PPSR organisation checks.
ppsr:search.serialRun PPSR serial-number checks.
abn:lookupLook up ABN and business identity data.
gst:statusCheck GST status.
assets:receiptsRead records and logs for completed checks.
exports:writeCreate Evidence Pack exports and audit artifacts.
assets:monitorMonitor approved entities and assets for source-backed changes.
mcp:account.receiptsRead MCP session logs for the connected account.

Supported hosts

ChatGPT Web boundary. Use Apps > Manage > Advanced settings > Create app where your ChatGPT account exposes private apps. Treat ChatGPT output as Hoist source-backed only after ChatGPT shows the Hoist Assets app and a Hoist tool result.
Gemini Web boundary. Hoist documents Gemini CLI for Google Gemini workflows. Gemini Web is not launch-supported for Hoist MCP until a verified remote connector path is available.
MCP host

Claude Desktop

Use the remote MCP endpoint with OAuth.

Install guide MCP host

Claude.ai

Add Hoist as a connector where your plan supports it.

Install guide Best effort

ChatGPT

Create a private app where ChatGPT exposes that setting.

Install guide MCP host

Cursor

Add Hoist to your MCP server config.

Install guide MCP host

Cline

Connect from the VS Code extension settings.

Install guide MCP host

Codex CLI

Register Hoist in Codex MCP config.

Install guide MCP host

Gemini CLI

Add Hoist to Gemini CLI settings.

Install guide Direct HTTP

curl

Useful for testing JSON-RPC calls and OAuth discovery.

Guide

Tools

The exact tool list is returned by tools/list. The first datasets are PPSR and ABN.

Tool familyWhat it answers
ppsr_searchIs there a PPSR registration against this business or asset?
abn_lookupDoes this business have a valid ABN?
verify_counterpartyCheck a counterparty using available Australian source data.
create_evidence_packBundle records for a subject into a downloadable pack.
show_due_diligence_receiptRead the log for a completed check.

See the tool reference for parameters and example calls.

API, MCP, or CLI?

UseChooseAuth
Your app or backend calls Hoist directly.APIBearer token.
An AI client needs delegated access for a user.MCPOAuth consent.
You are scripting checks from a terminal.CLI--token or HOIST_ASSETS_API_KEY.