HopGraph MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "AUTH_HEADER=${AUTH_HEADER}" hop-graph -- npx mcp-remote https://hopgraph.com/mcp/ --header "Authorization:${AUTH_HEADER}"
Required:AUTH_HEADER
README.md

Verify Australian and New Zealand businesses against government registers

HopGraph MCP Server

Verify Australian and New Zealand businesses against government registers via any MCP-compatible AI agent.

Returns registration status, directors, licences, trading names, and a three-tier risk assessment (CLEAR / ADVISORY / FLAGS_FOUND) that surfaces regulatory findings across jurisdictions — including bans, disqualifications, insolvencies, and disqualified directors that may not appear in any single register.

Each verification produces an immutable compliance record with a unique audit UID.

Compatible with Claude, ChatGPT, Cursor, and any MCP-compatible AI client.

Quick Start

1. Get a free API key

Sign up at hopgraph.com/signup. No credit card required.

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 configuration (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 it

Ask your AI assistant:

Verify business ABN 35002976294

You should see a full verification with company status, licence details, and a risk assessment.

Tools

`verify_business`

Verify any Australian or New Zealand business against government registers. Accepts ABN (11 digits), ACN (9 digits), NZBN (13 digits), or company name.

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 across entity licence chains. For New Zealand entities, checks every director against the NZ Companies Office Disqualified Directors and Insolvency registers in real time, and screens them against Australian regulatory registers.

Each verification produces an immutable compliance record with a unique audit UID. Findings are labelled as "Exact name match" or "Partial name match" so you can apply the appropriate level of scrutiny.

Parameter Required Description
identifier Yes ABN, ACN, NZBN, or company name to verify
country No AU or NZ. Auto-detected from identifier format if omitted

`search_business`

Search Australian and New Zealand business entities by name. Covers 2.3 million+ Australian companies, 3.2 million business names, and New Zealand NZBN-registered entities.

Use this to find the correct identifier before calling verify_business.

Parameter Required Description
query Yes Business name or partial name to search for
limit No Maximum results to return (default 20, max 50)

`expand_person_network`

Discover all NZ company directorships and shareholdings held by a named person via the NZ Companies Office register. Returns every company where the person holds a role — company name, NZBN, status, role type, and appointment date — plus flags for companies already in the HopGraph database.

Use this to map a person's corporate network beyond what a single entity lookup reveals.

Parameter Required Description
person_name Yes Full name of the person to search for (e.g. "Stephen Mikkelsen")
role_type No Filter by role type: DIR (directors), SHR (shareholders), or ALL (default)

`get_verification`

Retrieve a previously generated compliance verification record by its unique audit UID. Returns the immutable entity snapshot captured at verification time, data sources consulted with freshness timestamps, and the risk assessment result.

Parameter Required Description
verification_uid Yes The verification UID (UUID) returned by a previous verify_business call

`get_verification_history` Professional+

Retrieve the verification history for a specific entity, showing all past compliance checks you have run against it. Returns verification dates, risk assessment results, and audit UIDs. Useful for tracking how an entity's compliance status has changed over time.

Requires a Professional or Business tier API key — upgrade at hopgraph.com/billing.

Parameter Required Description
identifier Yes ABN, ACN, NZBN, or company name used in previous verify_business calls
limit No Maximum history records to return (default 20,

Tools (5)

verify_businessVerify any Australian or New Zealand business against government registers.
search_businessSearch Australian and New Zealand business entities by name.
expand_person_networkDiscover all NZ company directorships and shareholdings held by a named person.
get_verificationRetrieve a previously generated compliance verification record by its unique audit UID.
get_verification_historyRetrieve the verification history for a specific entity.

Environment Variables

AUTH_HEADERrequiredBearer token for API authentication

Configuration

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

Try it

Verify business ABN 35002976294 and provide the risk assessment.
Search for businesses with the name 'Tech Solutions' in Australia.
Map the corporate network for Stephen Mikkelsen in New Zealand.
Get the verification history for the company with NZBN 9429030000000.

Frequently Asked Questions

What are the key features of HopGraph?

Three-tier risk assessment (CLEAR / ADVISORY / FLAGS_FOUND). Cross-jurisdictional regulatory screening for bans and insolvencies. Immutable compliance records with unique audit UIDs. Real-time director and shareholder network mapping. Support for ABN, ACN, and NZBN identifiers.

What can I use HopGraph for?

Performing automated due diligence on potential business partners. Screening directors for disqualifications or insolvency history. Maintaining an audit trail of compliance checks for regulatory reporting. Mapping corporate networks to identify hidden conflicts of interest.

How do I install HopGraph?

Install HopGraph by running: npx mcp-remote https://hopgraph.com/mcp/

What MCP clients work with HopGraph?

HopGraph works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep HopGraph docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare