Skip to main content
Glama
businessapi-mcp

businessapi-mcp

by JoeFu

businessapi-mcp

CI PyPI License: MIT

MCP server for Business API — the Australian ASIC / ATO / ABRS / PPSR digital-service-provider API. Give Claude Code, Claude Desktop, Cursor or any MCP client the ability to look up ABNs and ACNs, check names, register companies, ABNs and business names, lodge ASIC agent forms, run PPSR searches, and monitor entities — with the sandbox as the default environment and every lodgement dry-run first.

You:    Register a company called ACME TRADING SANDBOX TEST PTY LTD in the sandbox
Claude: check_company_name_availability → Available
        get_request_schema("company_registration") → asks you for officeholders, addresses, shares
        lodge_company_registration(dry_run=true) → shows you the exact payload and fees
        lodge_company_registration(dry_run=false) → requestId 37363
        wait_for_request → finished · ACN 601510089 · document 0EACL6550

Install in three steps

Requires uv (it fetches and runs the package; nothing else to install).

  1. Get a key. Register at https://businessapi.com.au/register and create a key at https://businessapi.com.au/user/api-keys. Sandbox keys start with bapi_sk_test_, are free and need no card.

  2. Store it (prompted, hidden; saved to your user config directory, verified against the API):

    uvx businessapi-mcp setup
  3. Register the server with your client:

    uvx businessapi-mcp install claude-code      # or: claude-desktop · cursor · vscode · mcp-json

    This is equivalent to claude mcp add bapi -- uvx businessapi-mcp; the key never appears in client configuration. Not on PyPI yet, or want the latest commit? Add --git to run straight from GitHub (uvx --from git+https://github.com/JoeFu/businessapi-mcp businessapi-mcp).

Then open a new session and ask: "Which company has ABN 51 824 753 556?" (it calls lookup_abn) or "Register a company in the sandbox". uvx businessapi-mcp doctor runs a self-test against the sandbox if anything looks off, and uvx businessapi-mcp status shows which key and environment are active.

{ "mcpServers": { "bapi": { "command": "uvx", "args": ["businessapi-mcp"] } } }

Claude Desktop: claude_desktop_config.json. Cursor: ~/.cursor/mcp.json. VS Code: .vscode/mcp.json with "servers": { "bapi": { "type": "stdio", "command": "uvx", "args": ["businessapi-mcp"] } }. The key is read from the user config file written by setup, from ./.env, or from BAPI_API_KEY.

Related MCP server: AU-BizIntel MCP Server

How the model knows what to do

The vendor publishes no OpenAPI specification, only HTML documentation. This project turns that documentation into three things the model receives over MCP:

  1. Server instructions — environment, asynchronous lodgement flow, pricing, dry-run workflow, where to start.

  2. Tools — 46 of them, each with a description that says when to use it, what it costs and what to call next. Lodgement bodies are validated by Pydantic models whose field names match the vendor docs one-to-one, with the ASIC/ATO code tables as enums and the "Mandatory IF …" cross-field rules as validators.

  3. Resources — 12 guides under bapi://docs/* (endpoint catalogue, lifecycle, per-form guides, code tables) and the request schema of every lodgement under bapi://schemas/{form}.

Tools

Group

Tools

Notes

lookup

lookup_abn lookup_acn check_company_name_availability check_business_name_availability search_business_industries

free lookups

registrations

lodge_company_registration lodge_abn_registration lodge_business_name_registration lodge_business_name_renewal + status / payment-link tools, get_abn_entitlement_questionnaire, get_request_schema

Form 201, ABNREG, BNREG, BNRENEW

agent_forms

lodge_asic_484_form lodge_company_name_change lodge_company_deregistration lodge_asic_361_form lodge_asic_362_form request_asic_account_transactions + status tools

registered-agent forms 484 / 205A / 6010 / 361 / 362 / RA52

monitoring

start_entity_monitoring renew_entity_monitoring list_monitored_entities get_monitored_entity stop_entity_monitoring resume_entity_monitoring get_entity_snapshot list_monitoring_events get_monitoring_event simulate_monitoring_event

$18 per entity per year live

webhooks

list_webhooks create_webhook update_webhook delete_webhook rotate_webhook_secret verify_webhook_signature

signature check runs locally

ppsr

create_ppsr_search get_ppsr_search

$6 per search live

core

get_request_status wait_for_request get_account_status call_endpoint

polling, account, escape hatch

Every lodgement tool defaults to dry_run=true: it validates locally and returns the exact JSON that would be sent. The model has to pass dry_run=false to lodge — the natural "show the user the payload and fees, then confirm" step.

Safety model

  • Sandbox by default. The environment is inferred from the key prefix. bapi_sk_test_… only ever reaches https://businessapi.com.au/api/test/v2, where nothing is billed and nothing reaches production registries.

  • Live writes are blocked unless the server runs with BAPI_ALLOW_LIVE=true. With a live key every POST / PATCH / DELETE is refused before any HTTP call. Turn it on only when you intend to lodge.

  • testTransmissionIndicator is injected from the server environment and anything the model sends is ignored; simulate_monitoring_event refuses to run against live; monitoring orders and renewals need a caller-supplied idempotency key so retries never charge twice; TFNs are checksum-validated and never echoed; webhook secrets are returned once.

  • Tools carry MCP annotations (readOnlyHint, destructiveHint) and a toolset tag.

See SECURITY.md.

Configuration

Variable

Default

Effect

BAPI_API_KEY

—

the key; also read from ./.env or the file written by businessapi-mcp setup

BAPI_ENV

inferred from the key

test / live; only a cross-check, a mismatch is reported

BAPI_ALLOW_LIVE

off

must be true before any live POST / PATCH / DELETE

BAPI_INLINE_SCHEMAS

off

true puts the full lodgement schemas into tools/list

BAPI_TOOLSETS

all

comma-separated groups to expose (see below)

Lookup order: environment variables → ./.env in the directory the server starts from → the user config file (%APPDATA%\businessapi-mcp\.env, ~/Library/Application Support/businessapi-mcp/.env, ~/.config/businessapi-mcp/.env).

Context size: lazy schemas and toolsets

Inlining the full schemas of the lodgement tools into tools/list costs about 147k characters (~37k tokens) on every connection. By default the request parameter of each lodge_* tool is a plain JSON object and the model fetches the exact schema on demand with get_request_schema(form) or bapi://schemas/{form}; validation is unchanged and errors come back as a list of field paths.

Configuration

Tools

Chars

≈Tokens

BAPI_INLINE_SCHEMAS=true, all toolsets

46

146,619

36,654

default (lazy), all toolsets

46

52,432

13,108

BAPI_TOOLSETS=lookup,registrations,core

18

20,409

5,102

BAPI_TOOLSETS=agent_forms,core

15

17,893

4,473

BAPI_TOOLSETS=monitoring,webhooks

16

17,012

4,253

BAPI_TOOLSETS=lookup,ppsr

7

7,494

1,873

BAPI_TOOLSETS lets one package run as several small servers — see .mcp.json.example. Leaving core off a server also removes the call_endpoint escape hatch. Re-measure with uv run scripts/tools_list_size.py.

Command line

businessapi-mcp                      run the MCP server on stdio (what clients launch)
businessapi-mcp run --transport http --port 8000
businessapi-mcp setup [--local]      store the key (hidden prompt) and verify it
businessapi-mcp status               where the key comes from, which environment is active
businessapi-mcp doctor [--lodge]     sandbox self-test through the real tools; --lodge also lodges the examples
businessapi-mcp install <client>     claude-code | claude-desktop | cursor | vscode | mcp-json  (--dry-run, --dev REPO)

doctor refuses live keys. Its read-only run covers account status, lookups, name checks, industry search, the ABN entitlement questionnaire, a PPSR search polled to completion, a $0 monitoring order with a simulated event and list_webhooks; --lodge additionally submits the example company, sole-trader ABN and business-name payloads to the sandbox and polls them (observed: company finished with a test ACN, ABN validation ok, business name wating ASIC CC payment with an ASIC UAT payment link).

What the vendor docs get wrong (verified in the sandbox)

  • Two helpers need query parameters the docs omit: /helpers/business-industries?searchTerm= and /helpers/entitlement-questionnaire?entityType=&entitySubType=.

  • Every officeHolders[] entry in a company registration needs addressOverriddenIndicator (400 without it); the model defaults it to false.

  • Company registration POST answers {requestId, status, billing} at the top level, not {response: {requestId}}; the finished status uses registrationDate, not dateOfRegistration; ASIC rejections arrive as errors[].details.text (the full advice letter) with a snake_case response.

  • ABN lookups return PascalCase keys (EntityName, AbnStatus, …).

  • Share money fields: the rules say integers in cents, the vendor sample sends 100 for 100 × $1 shares, and the sandbox accepts either — agree the convention with the vendor before a live lodgement.

  • Several vendor samples carry the placeholder ACN 123456789, which fails the checksum their own docs require.

  • Endpoints without a public docs page (name reservations, extracts, tax/registrations, most RA forms, ASIC inbox) are reachable only through call_endpoint.

Development

git clone https://github.com/JoeFu/businessapi-mcp && cd businessapi-mcp
uv sync --group dev
uv run pytest                                   # offline: vendor samples, rules, server modes, CLI
uv run businessapi-mcp install claude-code --dev .   # point your client at this checkout
uv run businessapi-mcp doctor                   # needs a sandbox key in ./.env or via setup
uv run --group dev scripts/export_openapi.py    # refresh openapi.yaml after editing models.py

Layout: src/businessapi_mcp/ (server.py tools and docs, models.py request models, config.py key discovery, cli.py, smoke.py doctor, examples/), tests/ with the vendor samples as fixtures, scripts/ (OpenAPI export, an OpenAPI-generated alternative server, tools/list size measurement), openapi.yaml.

Adding a lodgement: write the request model in models.py, a _lodge_x(request, dry_run) implementation in server.py, and one row in the LODGEMENTS registry; lazy / inline mode, toolset filtering and get_request_schema follow automatically. Other tools use @tool("<group>", annotations=...).

Releases: push a v* tag; publish.yml builds and publishes to PyPI through trusted publishing.

License

MIT — see LICENSE. Not affiliated with Business API Pty Ltd, ASIC or the ATO.

Available Tools

46 tools
call_endpointCall EndpointA
Destructive

Call any Business API v2 endpoint that has no dedicated tool (ASIC forms, entity monitoring, webhooks, staged ABN data…).

path is RELATIVE to the v2 root, e.g. "/asic-484-forms", "/monitoring/entities/123", "/helpers/entitlement-questionnaire". Never include /api/v2 or /api/test/v2 — the server adds the right prefix for its environment. Find paths in resource bapi://docs/endpoints; field schemas are on https://businessapi.com.au/developers/api/. POST = lodge (returns requestId; follow with get_request_status). Live writes are blocked unless BAPI_ALLOW_LIVE=true. Prefer the typed lodge_* tools for company / ABN / business-name registrations: they validate before sending.

Inputs: path (required), method (required), body, query. Returns: object

check_business_name_availabilityCheck Business Name AvailabilityA
Read-only

Check a proposed BUSINESS (trading) name against ASIC's name test. Free helper.

holder_name: legal name of the entity that will hold the name (e.g. "ACME TRADING PTY LTD"). Strongly recommended: ASIC reports a match on the holder's own company name as "Identical", and with holder_name the response adds availableForHolder (lodge only when true) and marks such objections ownName: true. Response: availability (ASIC code, e.g. Available / Identical / ExistingBN), shortDescription, objections[] {code, level, description, message, matchedNames, ownName}. asicUnavailable: true means "could not check", not "available".

Inputs: name (required), holder_name. Returns: object

check_company_name_availabilityCheck Company Name AvailabilityA
Read-only

Check whether a proposed COMPANY name (including legal elements, e.g. "ACME PTY LTD") is available with ASIC. Free helper. Call this before lodge_company_registration or a name change / reservation.

Inputs: name (required). Returns: object

create_webhookCreate WebhookA

Register a webhook endpoint for this API key (max 10 per key). url must be HTTPS on a public host.

event_types: one or more of company_registration.status_changed, abn_registration.status_changed, business_name_registration.status_changed, business_name_renewal.status_changed, ppsr.alert.grantor_registration_changed, monitoring.change_detected, monitoring.expiring, monitoring.expired — or ["*"] for everything. The response includes the signing secret (whsec_…) ONCE: give it to the user to store immediately; GET never returns it (rotate_webhook_secret issues a new one). Read bapi://docs/webhooks for the delivery payload, signature check and retries.

Inputs: url (required), event_types (required). Returns: object

delete_webhookDelete WebhookA
DestructiveIdempotent

Remove a webhook endpoint. Deliveries stop immediately. Prefer update_webhook(enabled=false) to pause instead.

Inputs: webhook_id (required). Returns: object

get_abn_entitlement_questionnaireGet Abn Entitlement QuestionnaireA
Read-only

Fetch the ABN entitlement questionnaire for an ATO entity type / sub-type (e.g. 117/006 sole trader, 051/027 private company, 161/150 partnership, 212/077 trading trust, 210/196 SMSF; codes in bapi://docs/ato-codes). Free helper.

Walk the applicant through the questions and record each step as {questionId, answerId, nextQuestionId} in entitlement.questionnaire, plus firstQuestion / outcomeId / outcome, for lodge_abn_registration.

Inputs: entity_type (required), entity_sub_type (required). Returns: object

get_account_statusGet Account StatusA
Read-only

Account / plan state for the current API key: accountName, companyName, abn, createdAt, planId, planCreatedAt, planEndsAt and stats {abnLodgementForms, taxLodgementForms, acnLodgementsForms, acnRegisteredAgentForms, bnLodgementsForms, bnRenewLodgementsForms, bapiHelpers} (usage counters). Use it to explain 403s and plan limits.

Inputs: no named parameters. Returns: object

get_asic_484_form_statusGet Asic 484 Form StatusC
Read-only

Status of a Form 484 lodgement: {response: {requestId, status, documentNumber, info: {companyName, acn}}, errors}.

Inputs: request_id (required). Returns: object

get_asic_form_statusGet Asic Form StatusB
Read-only

Status of a Form 361 / 362 / RA52 lodgement: {response: {requestId, status, documentNumber, info {companyName, acn, type?}, records? (RA52)}, errors}.

Inputs: form (required), request_id (required). Returns: object

get_business_name_registration_statusGet Business Name Registration StatusA
Read-only

Status of a business-name registration. Statuses: new -> … -> "wating ASIC CC payment" (card: response has transactionPaymentUrl + transactionFee; the payer must open the link) -> finished (certificateUrl / receiptNumber, or transactionDocumentUrl for invoice payment). "cancelled" = payment link expired/declined: call refresh_business_name_payment_link, never re-lodge. "rejected" with errors["00133"] = name not available.

Inputs: request_id (required). Returns: object

get_business_name_renewal_statusGet Business Name Renewal StatusB
Read-only

Status of a business-name renewal: new -> … -> finished with response {transactionDocumentUrl, businessNameNumber, renewalTo}.

Inputs: request_id (required). Returns: object

get_company_deregistration_statusGet Company Deregistration StatusC
Read-only

Status of a deregistration: {response: {requestId, status, documentNumber, info {companyName, acn, companyType, companyClass, companySubClass, jurisdictionOfRegistration, dateOfDeregistration}}, errors}.

Inputs: request_id (required). Returns: object

get_company_name_change_statusGet Company Name Change StatusC
Read-only

Status of a name change: {requestId, status, documentNumber, response {companyName, acn, proposedName}, errors}. A request that failed local validation (never reached ASIC) returns only requestId, status and errors.

Inputs: request_id (required). Returns: object

get_entity_snapshotGet Entity SnapshotA
Read-only

The entity's current record from every monitored source, as JSON (snake_case inside snapshot): entity_details (ASIC/ABR names, addresses, statuses, business_names), registrations (AFS/credit licences, ACNC), trade_marks, insolvency_notices, ppsr. Active entities only: 409 entity_not_active / snapshot_not_ready (new entity, wait a few minutes) / not_available_in_sandbox (sandbox entities have no live data); 503 snapshot_unavailable -> retry later. 20 requests/min. The same record as a dated PDF: GET /monitoring/entities/{id}/report?includeRecent=true (binary; fetch outside MCP).

Inputs: entity_id (required). Returns: object

get_monitored_entityGet Monitored EntityA
Read-only

One monitored entity (see list_monitored_entities for the object). 404 not_found if it is not yours in this environment (ids are per account and per environment; a merged ABN entity's old id also returns 404 — re-read the list).

Inputs: entity_id (required). Returns: object

get_monitoring_eventGet Monitoring EventB
Read-only

One monitoring event in full: description, source (asic|abr|insolvency|ppsr|trademark|register), effectiveDate, metadata (field/oldValue/newValue; documentType/documentNumber for document_lodged; businessName; previousName; noticeUrl; tradeMark*; registerLabel/registerStatus/licenseeNumber/registerUrl; gstCancelled) and the entity object.

Inputs: event_id (required). Returns: object

get_request_schemaGet Request SchemaA
Read-onlyIdempotent

Return the JSON Schema (with $defs) for a lodge_* tool's request object. Call it before building a lodgement.

form -> tool: company_registration -> lodge_company_registration · abn_registration -> lodge_abn_registration · business_name_registration -> lodge_business_name_registration · business_name_renewal -> lodge_business_name_renewal · asic_484_form -> lodge_asic_484_form · company_name_change -> lodge_company_name_change · company_deregistration -> lodge_company_deregistration · asic_361_form -> lodge_asic_361_form · asic_362_form -> lodge_asic_362_form. Field descriptions carry the vendor's rules and enums are the ASIC/ATO code tables; cross-field "Mandatory IF" rules are enforced when you call the tool and reported as field errors. The same schema is readable at bapi://schemas/{form}.

Inputs: form (required). Returns: object

get_request_statusGet Request StatusA
Read-only

Poll any lodgement (company / ABN / tax / business-name registration, ASIC forms, deregistration…) by requestId.

Lifecycle: new -> transmission ok -> validation ok | validation failed -> manual review -> finished | rejected. On 'validation failed' / 'rejected' read errors[] ({details, target}); on 'manual review' read warnings; on 'finished' the result (e.g. acn, abn, dateOfRegistration, documentNumber) is in response (ABN: info). Use wait_for_request to block until a terminal state; use webhooks in production.

Inputs: request_id (required). Returns: object

list_monitored_entitiesList Monitored EntitiesA
Read-only

List monitored entities (data[] of entity objects + meta {currentPage, perPage, total, lastPage}). Filters: status, acn, abn, expires_before (YYYY-MM-DD, for renewal runs). per_page max 100. Entity object: id, acn, abn, entityName, reference, status, monitoringStatus (pending|active|degraded|inactive), startsAt, expiresAt, daysRemaining, lastEventAt, entityStatus (registered|deregistered|cancelled|external_administration| strike_off_proposed|unknown), entityType, gstRegistered, gstDate, businessNames[].

Inputs: abn, acn, page, status, +2 more. Returns: object

list_monitoring_eventsList Monitoring EventsA
Read-only

List detected changes (summary form: monitoringEventId, entityId, eventType, title, detectedAt, simulated).

Without entity_id: ALL your events, oldest first (GET /monitoring/events). since = the last monitoringEventId you processed (returns later events) or an ISO 8601 date-time — store the last id to catch up after webhook downtime. With entity_id: that entity's events, newest first. per_page max 100. eventType: document_lodged, name_change, address_change, status_change, type_change, gst_change, business_name_added, business_name_removed, insolvency_notice, ppsr_registration, trade_mark_filed / _status_change / _owner_change / _renewal_due / _renewed, register_added / _status_change / _removed / _conditions_change, other_change (treat unknown as other_change). Use get_monitoring_event for description, source, effectiveDate and metadata (oldValue/newValue, documentType …).

Inputs: page, since, per_page, entity_id. Returns: object

list_webhooksList WebhooksA
Read-only

List the webhook endpoints registered for THIS API key / environment (signing secrets are never returned).

Inputs: no named parameters. Returns: object

lodge_abn_registrationLodge Abn RegistrationA
Idempotent

Apply for an Australian Business Number (ATO ABNREG). LIVE cost ≈ $25.

request mirrors https://businessapi.com.au/developers/api/abn-registrations; read bapi://docs/abn-registrations (entity types, workflow, rules) and bapi://docs/ato-codes first. Sole trader = entityType 117 / entitySubType 006; company = 051/027 (needs the ACN); partnership = 161/087|150; trust = 212/…; SMSF = 210/196. The entitlement questionnaire answers come from get_abn_entitlement_questionnaire(entity_type, entity_sub_type); activity codes from search_business_industries(keyword). TFNs are sensitive: collect them, validate (checksum is checked locally), never repeat them back to the user.

dry_run=true (default): validate and return the payload (the server adds testTransmissionIndicator from its env). dry_run=false: lodge -> {requestId, status: "received", billing: {price_cents, charged_cents}}; a duplicate in-progress application returns the existing requestId with a warning. Then wait_for_request(requestId) -> 'finished' gives info.abn. HTTP 400 = field errors keyed by path, nothing charged.

request is a JSON object. Fetch its exact schema first with get_request_schema("abn_registration") (or read resource bapi://schemas/abn_registration), build the object, then call this tool; field errors come back as a readable list.

Inputs: request (required), dry_run. Returns: object

lodge_asic_361_formLodge Asic 361 FormA

Lodge ASIC Form 361 — YOUR registered-agent account ceases to act for a company (agent-initiated).

request = generalInformation {companyName, acn}, signature {name, role AGT, date, agentAuthorisedIndicator true, declaration true}. Billed as a registered-agent form. dry_run=true (default) returns the payload; dry_run=false lodges -> {response: {requestId, documentNumber, documentUrl}}. Then get_asic_form_status(form="361") / wait_for_request(kind="asic_361").

request is a JSON object. Fetch its exact schema first with get_request_schema("asic_361_form") (or read resource bapi://schemas/asic_361_form), build the object, then call this tool; field errors come back as a readable list.

Inputs: request (required), dry_run. Returns: object

lodge_asic_362_formLodge Asic 362 FormA

Lodge ASIC Form 362 — a company appoints (type A) or ceases (type C) your registered agent number (company-initiated).

Appointing links the company to your agent account, which the other ASIC form tools (484, 205A, 6010 …) need. request = generalInformation {companyName, acn, type A|C}, signature {name, role DIR|SEC, date, declaration true}. dry_run=true (default) returns the payload; dry_run=false lodges -> {response: {requestId, documentNumber, documentUrl}}. Then get_asic_form_status(form="362") / wait_for_request(kind="asic_362").

request is a JSON object. Fetch its exact schema first with get_request_schema("asic_362_form") (or read resource bapi://schemas/asic_362_form), build the object, then call this tool; field errors come back as a readable list.

Inputs: request (required), dry_run. Returns: object

lodge_asic_484_formLodge Asic 484 FormA

Lodge ASIC Form 484 — Changes to Company Details — for a company managed under your registered-agent account.

One form can combine any of: registeredOffice / principalPlaceOfBusiness address change, officeHolders (appointments, cessations, name/address changes), shareIssue or shareCancellation (both need shareStructure + members), ultimateHoldingCompany, concessionalFees, annexures. Always needs generalInformation {companyName, acn} and signature {name, role DIR|SEC|ALT, date within the last 6 months, declaresTrueAndCorrectIndicator true}. Read bapi://docs/asic-484-forms first for the status / holdingStatus / cancellationProvision codes and the V455 share-totals rule (checked locally). The server upper-cases all string values (ASIC requirement). ASIC charges late fees when a change is notified more than 28 days after it took effect. Billed as a registered-agent form (Pro plan includes 2,500 forms/month).

dry_run=true (default) validates and returns the payload; dry_run=false lodges -> {response: {requestId, documentNumber, documentUrl}}. Then get_asic_484_form_status / wait_for_request(kind="asic_484").

request is a JSON object. Fetch its exact schema first with get_request_schema("asic_484_form") (or read resource bapi://schemas/asic_484_form), build the object, then call this tool; field errors come back as a readable list.

Inputs: request (required), dry_run. Returns: object

lodge_business_name_registrationLodge Business Name RegistrationA

Register a business (trading) name with ASIC (BNREG). LIVE cost ≈ $15 service fee + ASIC fee (1 or 3 years).

request mirrors https://businessapi.com.au/developers/api/business-name-registrations; read bapi://docs/business-name-registrations first. Holder types: IND, IB (companies), PTSH, USTR, JV. Before lodging: check_business_name_availability(name, holder_name) and require availableForHolder == true. paymentMethod "card" -> after lodging, get_business_name_registration_status returns an ASIC payment link the payer must open; "invoice" -> ASIC emails an invoice (pay within 10 days).

dry_run=true (default): validate and return the payload. dry_run=false: lodge -> {requestId, status: "new"}. Then get_business_name_registration_status / wait_for_request(kind="business_name").

request is a JSON object. Fetch its exact schema first with get_request_schema("business_name_registration") (or read resource bapi://schemas/business_name_registration), build the object, then call this tool; field errors come back as a readable list.

Inputs: request (required), dry_run. Returns: object

lodge_business_name_renewalLodge Business Name RenewalA

Renew an existing business name with ASIC (BNRENEW) for 1 or 3 years. LIVE cost ≈ $15 service fee + ASIC renewal fee.

request: generalInformation {businessName exactly as registered, abn of the holder, term 1|3, email} and applicant {individual {familyName, givenNames}, declaresTrueAndCorrectIndicator true}. Check the current record first with lookup_abn (businessNames) if unsure of the exact name. dry_run=true (default) validates and returns the payload; dry_run=false lodges -> {requestId, status: "new"}. Then get_business_name_renewal_status / wait_for_request(kind="business_name_renewal") -> 'finished' gives response.businessNameNumber, renewalTo and transactionDocumentUrl.

request is a JSON object. Fetch its exact schema first with get_request_schema("business_name_renewal") (or read resource bapi://schemas/business_name_renewal), build the object, then call this tool; field errors come back as a readable list.

Inputs: request (required), dry_run. Returns: object

lodge_company_deregistrationLodge Company DeregistrationA
Destructive

Lodge ASIC Form 6010 — VOLUNTARY DEREGISTRATION of a company (irreversible once ASIC deregisters). LIVE: service fee + ASIC fee.

All six s.601AA declarations must be true (members agree, not trading, assets < $1,000, fees paid, no liabilities, no legal proceedings) — the validator refuses otherwise. request = general {companyName, acn, paymentMethod DDEB|INV}, declarations, applicant (the company as organisation + role, or an individual), nominee {individual, address} to receive ASIC correspondence, signatory {individual, role, dateSigned, declaration true}. Read bapi://docs/asic-agent-forms. dry_run=true (default) validates and returns the payload; dry_run=false lodges -> {response: {requestId}}. Then get_company_deregistration_status / wait_for_request(kind="company_deregistration") -> finished with info.dateOfDeregistration. Transmission log: GET /company-deregistrations/{requestId}/logs (call_endpoint).

request is a JSON object. Fetch its exact schema first with get_request_schema("company_deregistration") (or read resource bapi://schemas/company_deregistration), build the object, then call this tool; field errors come back as a readable list.

Inputs: request (required), dry_run. Returns: object

lodge_company_name_changeLodge Company Name ChangeA

Lodge ASIC Form 205A — change a registered company's name. LIVE: service fee + ASIC fee (paymentMethod DDEB or INV).

Before lodging: check_company_name_availability(proposedName). request = generalInformation {companyName, acn, companyType, proposedName (with legal elements), meetingDate, meetingResolutionText (the special resolution), paymentMethod DDEB|INV, optional acnName*/nameReserved*/nameIdentical* flags}, signatory {individual, role DIR|SEC…, dateSigned, declaration true}, admin {manualReviewIndicator}. Read bapi://docs/asic-agent-forms. Requires registered-agent onboarding for the company. dry_run=true (default) validates and returns the payload; dry_run=false lodges -> {requestId, status: "sent"}. Then get_company_name_change_status / wait_for_request(kind="company_name_change") -> finished; certificate PDF at GET /company-name-changes/{requestId}/certificate (binary, outside MCP).

request is a JSON object. Fetch its exact schema first with get_request_schema("company_name_change") (or read resource bapi://schemas/company_name_change), build the object, then call this tool; field errors come back as a readable list.

Inputs: request (required), dry_run. Returns: object

lodge_company_registrationLodge Company RegistrationA

Lodge ASIC Form 201 — register a new Australian company. LIVE cost ≈ $50 service fee + ASIC registration fee.

request mirrors https://businessapi.com.au/developers/api/company-registrations field-for-field; read bapi://docs/company-registrations (workflow + rules) and bapi://docs/asic-codes (code tables) first. Typical Pty Ltd: companyType APTY, companyClass LMSH, companySubClass PROP, one ORD share class, ≥1 director. Before lodging: check_company_name_availability(name).

dry_run=true (default): validate locally (all "Mandatory IF" rules from the docs) and return the exact JSON that would be posted — show it and the fees to the user. dry_run=false: lodge; returns {requestId, status: "new", billing}. Then wait_for_request(requestId) -> 'finished' gives acn / registrationDate / documentNumber; certificate PDF at GET /company-registrations/{requestId}/certificate, document pack at …/documents.

request is a JSON object. Fetch its exact schema first with get_request_schema("company_registration") (or read resource bapi://schemas/company_registration), build the object, then call this tool; field errors come back as a readable list.

Inputs: request (required), dry_run. Returns: object

lookup_abnLookup AbnA
Read-only

Validate an Australian Business Number (ABN) and look it up on the ABR.

abn: 11 digits (spaces allowed). Free, read-only, no lodgement. Use this before any registration, PPSR or monitoring call that needs a confirmed ABN / entity name. Response (ABR data, PascalCase keys): Abn, AbnStatus (Active / Cancelled), AbnStatusEffectiveFrom, Acn, EntityName, EntityTypeCode / EntityTypeName, Gst (GST registration date, empty if none), AddressState, AddressPostcode, AddressDate, BusinessName[] (current business names), Message (non-empty when the ABN is unknown or invalid).

Inputs: abn (required). Returns: object

lookup_acnLookup AcnA
Read-only

Validate an Australian Company Number (ACN) and look the company up on ASIC.

acn: 9 digits (spaces allowed). Free, read-only. Response (ASIC data): name, type (e.g. Australian Proprietary Company), class, subClass, status (Registered / Deregistered …), incorporationState, registrationDate, addresses[] {type, address, suburb, postcode, state}.

Inputs: acn (required). Returns: object

renew_entity_monitoringRenew Entity MonitoringA
Idempotent

Renew monitoring for up to 25 entities for another 12 months. LIVE cost $18.00 per entity; sandbox $0.

Monitoring never auto-renews: act on monitoring.expiring webhooks (30 and 7 days before expiry) or list_monitored_entities with expires_before. idempotency_key is REQUIRED by the API (400 without it): your unique string per renewal batch, reused on retries so a timed-out retry never buys a second year. Active entities: the new term starts at the current expiry; expired: today. Expiry can't go more than 2 years ahead (renewal_too_far_ahead). A stopped entity with time left must be resumed, not renewed. Deregistered companies / cancelled ABNs can't be renewed. Any id not yours -> whole request 404, nothing charged. Response has the order shape {unitPrice, total, entities}. dry_run=true (default) returns the payload only.

Inputs: entity_ids (required), idempotency_key (required), dry_run. Returns: object

request_asic_account_transactionsRequest Asic Account TransactionsA
Idempotent

Request ASIC Form RA52 — a report of all transactions on your registered-agent ASIC account for a period (invoices, fees, direct debits, late fees, payments). Dates YYYY-MM-DD, end_date ≤ today. Billed as a registered-agent form (no legal effect). Returns {response: {requestId, documentNumber}}; then get_asic_form_status(form="ra52") / wait_for_request(kind="asic_ra52") -> finished with response.records[] {date, legend (Table 0019, e.g. Invoice, Direct Debit, Late Fee), status (Table 0020, e.g. Outstanding, Fully Allocated), value / outstandingValue (signed cents as strings, "+49500" = $495.00), reference, acn}.

Inputs: end_date (required), start_date (required), dry_run, include_prior_outstanding. Returns: object

resume_entity_monitoringResume Entity MonitoringA
Idempotent

Resume a stopped entity whose paid term is still running (free). Changes that happened while stopped are not sent. 422 not_resumable = term already ended -> renew_entity_monitoring instead; 422 acn_not_eligible / abn_not_active = the company was deregistered / ABN cancelled meanwhile.

Inputs: entity_id (required). Returns: object

rotate_webhook_secretRotate Webhook SecretA
Destructive

Invalidate the endpoint's current signing secret and issue a new one (returned ONCE). The receiver must accept both the old and new secret until the new one is deployed everywhere.

Inputs: webhook_id (required). Returns: object

search_business_industriesSearch Business IndustriesA
Read-only

Search the ATO main-business-activity list by keyword (e.g. "cleaning", "software", "cafe"). Free helper.

Returns {searchTerm, activitiesCount, activities: [{score, code, industryCode, fullName}]} ranked by relevance. Use code (4 digits, e.g. 7749) as businessActivity.code and fullName as businessActivity.description in an ABN application; industryCode is the ANZSIC class. The endpoint needs a search term — there is no full list.

Inputs: search_term (required). Returns: object

simulate_monitoring_eventSimulate Monitoring EventA

SANDBOX ONLY: make a sandbox entity emit a test event + webhook. Give exactly one of: event_type — a change event such as document_lodged, address_change, status_change, gst_change, trade_mark_filed … (returns the event); simulate — expiring_30 | expiring_7 | expired (lifecycle webhooks) or deregistered (permanently marks the test entity deregistered; renew/resume are then refused). Refused in the live environment (the API returns 404 there too).

Inputs: entity_id (required), simulate, event_type. Returns: object

start_entity_monitoringStart Entity MonitoringA
Idempotent

Start monitoring up to 25 companies (acn) and/or ABN holders (abn) for public-register changes, prepaid 12 months each.

LIVE cost $18.00 per entity (card billing required); sandbox $0. Sources: ASIC, ABR, insolvency notices and PPSR (companies), IP Australia trade marks, ASIC licence registers, ACNC. Changes arrive as monitoring.change_detected webhooks and through list_monitoring_events. Read bapi://docs/entity-monitoring first. entities: [{acn}, {abn}, {acn, abn}], each with an optional reference (≤100 chars) of your own. ARBNs are not accepted. idempotency_key: YOUR unique string for this order (≤255 chars, e.g. "order-2026-11-18-acme"). A retried call with the same key never charges twice — reuse it when retrying after a timeout or a 202 "processing" answer. Response 201 {unitPrice, total (cents), entities: [entity objects]}; 422 validation_failed carries per-row errors (already_monitored -> renew_entity_monitoring; stopped_with_time_remaining -> resume_entity_monitoring); nothing charged on errors. dry_run=true (default) validates locally and returns the payload.

Inputs: entities (required), idempotency_key (required), dry_run. Returns: object

stop_entity_monitoringStop Entity MonitoringA
DestructiveIdempotent

Stop monitoring an entity now. Webhooks stop immediately; the paid term keeps running (no refund) and the entity can be resumed free until it ends; stopped time is not added back. Safe to repeat. 409 order_processing while an order/renewal for it is still processing — retry in a few minutes.

Inputs: entity_id (required). Returns: object

update_webhookUpdate WebhookA
Idempotent

Update a webhook endpoint's URL, event types and/or enabled flag (PATCH). Re-enabling (enabled=true) after an automatic disable (20 consecutive failures) resets its failure count. Give at least one field.

Inputs: webhook_id (required), url, enabled, event_types. Returns: object

verify_webhook_signatureVerify Webhook SignatureA
Read-only

Verify a Business API webhook delivery LOCALLY (no network): recompute HMAC-SHA256 over "{t}.{raw_body}" with the endpoint's whsec_ secret and compare it to v1 from the X-Bapi-Signature header ("t=1785552011,v1=") in constant time. raw_body must be the exact bytes received (re-serialised JSON breaks the hash). Returns {valid, reason, ageSeconds}. Use it to debug a receiver; in production implement the same check in the receiver itself.

Inputs: secret (required), raw_body (required), signature_header (required), tolerance_seconds. Returns: object

wait_for_requestWait For RequestA
Read-only

Poll a request until it reaches a terminal (or action-needed) state, then return that status response.

kind: "lodgement" -> GET /status/{id} (company registration, ABN); "ppsr" -> GET /ppsr/searches/{id}; "business_name" / "business_name_renewal" / "asic_484" / "company_name_change" / "company_deregistration" / "asic_361" / "asic_362" / "asic_ra52" -> that endpoint's own /{id}/status path. Stops on: finished, rejected, validation failed, completed, failed, cancelled, "wating ASIC CC payment" (business name needs the payer to open the link), or any HTTP error. timeout_seconds max 600. Returns the last status plus {"timedOut": bool, "polls": n}. Registrations in the sandbox usually finish in seconds to a few minutes; live ASIC/ATO processing can take longer — prefer webhooks for production.

Inputs: request_id (required), kind, poll_seconds, timeout_seconds. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 46 tools

    Disambiguation3/5

    Most tools target distinct resources/actions, but `call_endpoint` overlaps with every dedicated tool, and `get_request_status` / `wait_for_request` overlap with the many form-specific status getters. The descriptions clarify boundaries, but an agent still has multiple plausible choices for checking or calling the same lifecycle.

    Naming Consistency5/5

    Tool names consistently use snake_case verb_resource patterns such as `lodge_company_registration`, `get_webhook` variants, and `create_ppsr_search`. Numeric form names like `lodge_asic_484_form` are still predictable and aligned with the domain.

    Tool Count2/5

    46 tools is heavy for an agent-facing surface, especially with many form-specific lodge/status pairs that could be consolidated behind form parameters. The domain is broad, but the count exceeds a well-scoped set and increases selection burden.

    Completeness5/5

    The surface covers lookups, registrations, ASIC forms, PPSR searches, entity monitoring, webhooks, account status, schemas, and a generic endpoint fallback. Lifecycle coverage is strong, with lodgement, status polling, waiting, and webhook alternatives all represented.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      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.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Gives any MCP-compatible AI agent instant access to the Australian Business Register (ABR) — plus AI-powered business intelligence. Search 8M+ registered Australian entities by name or ABN, get full profiles, check GST status, and get an AI-generated opportunity assessment for any business.
      30 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that provides tools to look up and verify Australian businesses using the Australian Business Register API, enabling AI agents to retrieve business details via ABN, ACN, or name search.
      3
      ISC
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables company hierarchy analysis and address verification through MCP, allowing submission of entities for screening, duplicate detection, and status polling.
      -