Hopgraph Mcp

Created By
j-sulliman3 months ago
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, and insolvencies 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.
Overview

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, and insolvencies 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) that surfaces regulatory findings across jurisdictions — including bans, disqualifications, and insolvencies that may not appear in any single register.

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

ParameterRequiredDescription
identifierYesABN, ACN, NZBN, or company name to verify
countryNoAU 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.

ParameterRequiredDescription
queryYesBusiness name or partial name to search for
limitNoMaximum results to return (default 20, max 50)

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.

ParameterRequiredDescription
verification_uidYesThe 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.

ParameterRequiredDescription
identifierYesABN, ACN, NZBN, or company name used in previous verify_business calls
limitNoMaximum history records to return (default 20, max 100)

Coverage

SourceRecordsCountry
ASIC Companies2.3M+Australia
ASIC Business Names3.2M+Australia
ASIC Financial Advisers87K+Australia
ASIC AFS Licences6.5K+Australia
ASIC Credit Licences4.5K+Australia
ASIC Credit Representatives50K+Australia
ASIC Banned & Disqualified Persons7K+Australia
ASIC Banned Organisations15+Australia
NZBN RegisterLive APINew Zealand

Pricing

TierVerificationsRate LimitPrice
Free50/month10 req/minFree

REST API

HopGraph also provides a REST API. See hopgraph.com/docs for full documentation.

Findings are factual observations from public government registers, not identity assertions. Professional judgment should be applied to all results. See Terms of Service and Privacy Policy.

Australian data sourced from ASIC under Creative Commons Attribution 3.0 Australia. New Zealand data sourced from the NZBN Register maintained by MBIE.

Server Config

{
  "mcpServers": {
    "hopgraph": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://hopgraph.com/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Project Info
Created At
3 months ago
Updated At
3 months ago
Author Name
j-sulliman
Star
-
Language
-
License
-
Category

Recommend Servers

View All
Meteomatics

a day ago
GovQL
@Alex Stout

# govql-mcp-server An MCP (Model Context Protocol) server for [GovQL](https://govql.us) — gives AI clients like Claude Desktop, Claude Code, and Cursor direct access to the US Congressional GraphQL API at [api.govql.us/graphql](https://api.govql.us/graphql) without bespoke HTTP wiring. For the design rationale (why FastMCP-Python, the passthrough+curated philosophy, roadmap through v0.4), see [design.md](https://github.com/govql/govql/blob/main/mcp-server/docs/design.md). ## What you can do with it Ask an agent questions like: - *"How did Vermont's two senators vote on the most recent nomination?"* - *"Which legislators in the 118th Congress switched parties during their service?"* - *"Compare Senator Sanders' voting record to Senator Murkowski's on cloture votes in the most recent Congress."* The agent picks the right tool, writes the GraphQL query against the live schema, and parses the response — no manual API wrangling. ## Install The server runs as a per-client subprocess over stdio. Pick your client: ### Claude Desktop Edit `claude_desktop_config.json` (Settings → Developer → Edit Config): ```json { "mcpServers": { "govql": { "command": "uvx", "args": ["govql-mcp-server"] } } } ``` Restart Claude Desktop. The `govql` tools appear in the tools panel. ### Claude Code Add to `.mcp.json` in your project (or `~/.mcp.json` for global): ```json { "mcpServers": { "govql": { "command": "uvx", "args": ["govql-mcp-server"] } } } ``` ### Cursor Settings → MCP → Add Server. Use the same `command` / `args` as above. ### Other clients Any MCP-compatible client that supports stdio servers will work. The command is `uvx govql-mcp-server` with no required arguments. ## Tools | Tool | Purpose | |---|---| | `execute_graphql` | Run any GraphQL query against the GovQL endpoint. Returns the result plus an `last_ingest` timestamp so the agent can reason about data freshness. | | `list_types` | Returns the names and kinds of every type in the GovQL schema. Optional `kind` filter (`"OBJECT"`, `"INPUT_OBJECT"`, `"ENUM"`, etc.) to narrow further. Start here when you don't know what's queryable. | | `describe_type` | Returns one type's full details — fields, arg signatures, input fields, enum values. Call after `list_types` to learn the shape of a specific type before writing a query. | ## Configuration All env vars are optional — the package is zero-config for end users. | Env var | Default | Purpose | |---|---|---| | `GOVQL_ENDPOINT` | `https://api.govql.us/graphql` | Endpoint to query. Override to point at a local dev stack. | | `GOVQL_TIMEOUT_MS` | `30000` | Per-request HTTP timeout. | | `LOG_LEVEL` | `INFO` | Logging level. Logs go to stderr only (stdout is reserved for the MCP transport). | ## Limits (enforced by the upstream API) - Max query depth: 10 - Max query complexity: ~10 billion points (`first: N` multiplies child cost by N — keep page sizes reasonable on deeply nested queries) - Rate limit: 100 requests / 60 s per source IP A depth or complexity violation surfaces as a GraphQL `errors` entry in the tool response so the agent can adjust and retry. ## Data freshness Every `execute_graphql` response includes a `last_ingest` ISO timestamp. Vote data refreshes hourly; legislator data refreshes daily. ## Status Version 0.1.0 ships three foundational tools: a GraphQL passthrough (`execute_graphql`) and two narrow schema-discovery tools (`list_types`, `describe_type`). Curated higher-level tools (`find_legislator`, `get_voting_record`, `compare_voters`, etc.) are planned for subsequent releases — see [design.md](https://github.com/govql/govql/blob/main/mcp-server/docs/design.md) for the roadmap. ## Links - [GovQL project site](https://govql.us) - [GraphQL API](https://api.govql.us/graphql) - [Source / issues](https://github.com/govql/govql)

a day ago
Hellogrowthcrm

15 hours ago
Meok Bs7121 Mcp

9 hours ago