# Australian Business Verification MCP Server

A Model Context Protocol (MCP) server that provides AI agents (like Claude) with tools to look up and verify Australian businesses using the official Australian Business Register (ABR) JSON API.

## Features

This server exposes three core tools to the LLM:

- **`lookup_abn`**: Retrieve business details (entity name, GST status, entity type) using an 11-digit Australian Business Number (ABN).
- **`lookup_acn`**: Retrieve company details using a 9-digit Australian Company Number (ACN).
- **`search_by_name`**: Search the register for active or historical entities by their business or legal name.

## Prerequisites

- Node.js (v18+)
- An official **ABR GUID** (API Key). You can apply for one via the [Australian Business Register website](https://abr.business.gov.au/Tools/WebServices).

## Setup & Installation

1. **Install dependencies:**

```bash
npm install
```

2. **Configure Environment Variables:**
   Create a `.env` file in the root directory and add your ABR GUID:

```plaintext
ABR_GUID=your_guid_here
```

3. **Build the project:**

```bash
npm run build
```

4. **Using with Claude Desktop:**
   Add the server to your Claude Desktop configuration file.

- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`

````json
{
  "mcpServers": {
    "australian-business-verification-mcp": {
      "command": "node",
      "args": [
        "YOUR_ABSOLUTE_PATH_TO/australian-business-verification-mcp/build/index.js"
      ],
      "env": {
        "ABR_GUID": "your_guid_here"
      }
    }
  }
}
d```
> Note: Make sure to replace `YOUR_ABSOLUTE_PATH_TO` with your actual path, and provide your real ABR_GUID.
````