Setup Guide

AI Agent (MCP)

Add the HopGraph MCP server to Claude Desktop, ChatGPT, or any MCP-compatible AI agent. Your assistant can then verify any Australian business as part of your existing workflow.

1. Get your API key

If you don’t have one yet, create a free API key.

2. Add to Claude Desktop

Open your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following (replace YOUR_API_KEY with your actual key):

{
  "mcpServers": {
    "hopgraph": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://hopgraph.com/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

3. Restart Claude Desktop

After saving the config, restart the app. You’ll see the HopGraph tools available in your conversation.

4. Test your setup

Type this into Claude Desktop:

Verify business ABN 35002976294

You should see a full verification with company status, licence details, and adviser screening findings — including cross-referenced alerts that a standard registry check would miss. If you see that, you’re good to go.

Available tools

Once connected, your AI assistant can use these tools:

verify_business — Verify any Australian or New Zealand business against government registers. Returns registration status, directors, licences, trading names, and a three-tier risk assessment (CLEAR / ADVISORY / FLAGS_FOUND) that surfaces regulatory findings across jurisdictions.
search_business — Search 2.3M+ Australian companies, 3.2M business names, and NZ NZBN-registered entities. Use this to find the correct identifier before verifying.
get_verification — Retrieve a previously generated compliance record by its unique audit UID.
get_verification_history Professional+ — Retrieve the verification history for an entity, showing how its compliance status has changed over time.

Just ask your assistant naturally: “Verify Capstone Financial Planning” or “Check ABN 24093733969”.

REST API

Call the API directly from your application. Same cross-referencing, same compliance records.

Authentication

Include your API key as a Bearer token in the Authorization header:

Authorization: Bearer hg_your_api_key_here

Endpoints

Verify by ABN

GET /v1/au/entity/{abn}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://hopgraph.com/v1/au/entity/24093733969

Verify by ACN

GET /v1/au/entity/{acn}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://hopgraph.com/v1/au/entity/093733969

Auto-detect identifier

GET /v1/entity/{identifier}

# Works with ABN, ACN, or NZBN
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://hopgraph.com/v1/entity/24093733969

Search by name

GET /v1/search?q={query}&limit={n}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://hopgraph.com/v1/search?q=capstone+financial&limit=5"

Retrieve a compliance record

GET /v1/verification/{uid}

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://hopgraph.com/v1/verification/abc12345-6789-...

Response format

All responses follow the same structure:

{
  "status": "success",
  "data": { ... },
  "meta": {
    "request_id": "...",
    "timestamp": "2026-03-05T10:30:00Z"
  }
}

The data object contains the full entity profile including company details, regulatory flags, licences, adviser screening findings, and the verification UID for audit retrieval.

Tier	Verifications	Rate limit
Free	5/month	10 req/min
Professional	Unlimited	60 req/min
Business	Unlimited	120 req/min