{
  "markdown": "# HopGraph MCP Server\n\nVerify Australian and New Zealand businesses against government registers via any MCP-compatible AI agent.\n\nReturns 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.\n\nEach verification produces an immutable compliance record with a unique audit UID.\n\nCompatible with Claude, ChatGPT, Cursor, and any MCP-compatible AI client.\n\n## Quick Start\n\n### 1. Get a free API key\n\nSign up at [hopgraph.com/signup](https://hopgraph.com/signup). No credit card required.\n\n### 2. Add to Claude Desktop\n\nOpen your Claude Desktop config file:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nAdd the following configuration (replace `YOUR_API_KEY` with your actual key):\n\n```json\n{\n  \"mcpServers\": {\n    \"hopgraph\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https://hopgraph.com/mcp/\",\n        \"--header\",\n        \"Authorization:${AUTH_HEADER}\"\n      ],\n      \"env\": {\n        \"AUTH_HEADER\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n### 3. Restart Claude Desktop\n\nAfter saving the config, restart the app. You'll see the HopGraph tools available in your conversation.\n\n### 4. Test it\n\nAsk your AI assistant:\n\n> Verify business ABN 35002976294\n\nYou should see a full verification with company status, licence details, and a risk assessment.\n\n## Tools\n\n### `verify_business`\n\nVerify any Australian or New Zealand business against government registers. Accepts ABN (11 digits), ACN (9 digits), NZBN (13 digits), or company name.\n\nReturns 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.\n\nEach 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.\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `identifier` | Yes | ABN, ACN, NZBN, or company name to verify |\n| `country` | No | `AU` or `NZ`. Auto-detected from identifier format if omitted |\n\n### `search_business`\n\nSearch 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.\n\nUse this to find the correct identifier before calling `verify_business`.\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `query` | Yes | Business name or partial name to search for |\n| `limit` | No | Maximum results to return (default 20, max 50) |\n\n### `expand_person_network`\n\nDiscover 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.\n\nUse this to map a person's corporate network beyond what a single entity lookup reveals.\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `person_name` | Yes | Full name of the person to search for (e.g. \"Stephen Mikkelsen\") |\n| `role_type` | No | Filter by role type: `DIR` (directors), `SHR` (shareholders), or `ALL` (default) |\n\n### `get_verification`\n\nRetrieve 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.\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `verification_uid` | Yes | The verification UID (UUID) returned by a previous `verify_business` call |\n\n### `get_verification_history` <sup>Professional+</sup>\n\nRetrieve 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.\n\nRequires a Professional or Business tier API key — upgrade at [hopgraph.com/billing](https://hopgraph.com/billing).\n\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `identifier` | Yes | ABN, ACN, NZBN, or company name used in previous `verify_business` calls |\n| `limit` | No | Maximum history records to return (default 20, max 100) |\n\n## Coverage\n\n| Source | Records | Country |\n|--------|---------|---------|\n| ASIC Companies | 2.3M+ | Australia |\n| ASIC Business Names | 3.2M+ | Australia |\n| ASIC Financial Advisers | 87K+ | Australia |\n| ASIC AFS Licences | 6.5K+ | Australia |\n| ASIC Credit Licences | 4.5K+ | Australia |\n| ASIC Credit Representatives | 50K+ | Australia |\n| ASIC Banned & Disqualified Persons | 7K+ | Australia |\n| ASIC Banned Organisations | 15+ | Australia |\n| NZBN Register | Live API | New Zealand |\n| NZ Companies Office Disqualified Directors | Live API | New Zealand |\n| NZ Companies Office Insolvency Register | Live API | New Zealand |\n\n## Chat Interface\n\nA browser-based chat interface is available at [hopgraph.com/chat](https://hopgraph.com/chat) for professionals who prefer to work directly in the browser. Same cross-referencing, same compliance records. Supports all MCP tool capabilities including person network expansion and verification history.\n\n## Pricing\n\n| Tier | Verifications | Rate Limit | Price |\n|------|---------------|------------|-------|\n| Free | 50/month | 10 req/min | Free |\n\n## REST API\n\nHopGraph also provides a REST API. See [hopgraph.com/docs](https://hopgraph.com/docs) for full documentation.\n\n## Legal\n\nFindings are factual observations from public government registers, not identity assertions. Each match is labelled with its confidence level. Professional judgment should be applied to all results. See [Terms of Service](https://hopgraph.com/terms) and [Privacy Policy](https://hopgraph.com/privacy).\n\nAustralian data sourced from ASIC under Creative Commons Attribution 3.0 Australia. New Zealand data sourced from the NZBN Register and NZ Companies Office registers (Disqualified Directors, Insolvency) maintained by MBIE.\n",
  "bytes": 6771,
  "sha": "ad15f411c43ef8734a1eb3e794f394904da7e90084ed65b794fb5f81fe4795dd",
  "repo_slug": "j-sulliman/hopgraph-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_j_sulliman_hopgraph_9eeccf8e/readme"
}