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 or New Zealand business as part of your existing workflow — including real-time screening against disqualified directors and insolvency registers.

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.

Try a New Zealand entity too:

Verify business NZBN 9429036352715

NZ verifications screen every director against the Companies Office Disqualified Directors and Insolvency registers in real time, and cross-reference them against Australian regulatory registers.

Available tools

Once connected, your AI assistant can use these tools:

• verify_business — Verify any Australian or New Zealand business against 11 government data sources. Returns registration status, directors, licences, trading names, and a three-tier risk assessment (CLEAR / ADVISORY / FLAGS_FOUND). For Australian entities, cross-references adviser registrations against banned persons registers. For New Zealand entities, screens every director against the Companies Office Disqualified Directors and Insolvency registers in real time. Findings are labelled as “Exact name match” or “Partial name match”.
• 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.
• expand_person_network — Discover all NZ company directorships and shareholdings held by a named person via the Companies Office register. Use this to map a person’s corporate network beyond what a single entity lookup reveals.
• get_verification — Retrieve a previously generated compliance record by its unique audit UID. Records are scoped to the account that created them.
• get_verification_history Starter+ — 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”, “Check NZBN 9429036352715”, or “Expand Kevin Adams”.

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

GET /v1/au/entity/{abn}

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

GET /v1/au/entity/{acn}

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

GET /v1/nz/entity/{nzbn}

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

GET /v1/entity/{identifier}

Auto-detects: ABN (11 digits), ACN (9 digits), or NZBN (13 digits).

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

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

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

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, directors, regulatory flags, licences, adviser screening findings, NZ adverse screening results, and the verification UID for audit retrieval.

Chat Interface

Prefer to work in the browser? A conversational chat interface is available at /chat with the same cross-referencing, adverse screening, and compliance records. Supports all capabilities including person network expansion and verification history.

Data Sources

HopGraph cross-references 11 government data sources across Australia and New Zealand:

Rate Limits

When you exceed your monthly limit, the API returns 403 with a message indicating your quota has been reached.