businessapi-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@businessapi-mcp Which company has ABN 51 824 753 556?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
businessapi-mcp
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 0EACL6550Install in three steps
Requires uv (it fetches and runs the package; nothing else to install).
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.Store it (prompted, hidden; saved to your user config directory, verified against the API):
uvx businessapi-mcp setupRegister the server with your client:
uvx businessapi-mcp install claude-code # or: claude-desktop · cursor · vscode · mcp-jsonThis 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--gitto 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:
Server instructions — environment, asynchronous lodgement flow, pricing, dry-run workflow, where to start.
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.
Resources — 12 guides under
bapi://docs/*(endpoint catalogue, lifecycle, per-form guides, code tables) and the request schema of every lodgement underbapi://schemas/{form}.
Tools
Group | Tools | Notes |
|
| free lookups |
|
| Form 201, ABNREG, BNREG, BNRENEW |
|
| registered-agent forms 484 / 205A / 6010 / 361 / 362 / RA52 |
|
| $18 per entity per year live |
|
| signature check runs locally |
|
| $6 per search live |
|
| 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 reacheshttps://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.testTransmissionIndicatoris injected from the server environment and anything the model sends is ignored;simulate_monitoring_eventrefuses 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 |
| — | the key; also read from |
| inferred from the key |
|
| off | must be |
| off |
|
|
| 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 |
| 46 | 146,619 | 36,654 |
default (lazy), all toolsets | 46 | 52,432 | 13,108 |
| 18 | 20,409 | 5,102 |
| 15 | 17,893 | 4,473 |
| 16 | 17,012 | 4,253 |
| 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 needsaddressOverriddenIndicator(400 without it); the model defaults it tofalse.Company registration POST answers
{requestId, status, billing}at the top level, not{response: {requestId}}; the finished status usesregistrationDate, notdateOfRegistration; ASIC rejections arrive aserrors[].details.text(the full advice letter) with a snake_caseresponse.ABN lookups return PascalCase keys (
EntityName,AbnStatus, …).Share money fields: the rules say integers in cents, the vendor sample sends
100for 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 throughcall_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.pyLayout: 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 toolscall_endpointCall EndpointADestructive
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 AvailabilityARead-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 AvailabilityARead-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_ppsr_searchCreate Ppsr SearchA
Create a PPSR (Personal Property Securities Register) search. LIVE cost: $6.00 per search.
Provide exactly ONE identifier set:
abn | acn | arbn | arsn -> grantor search by number (certificate yes)
vin -> vehicle serial search + NEVDIS vehicle data
serial_number + serial_number_type -> non-VIN serial search (ChassisNumber | HIN | OfficialNumber)
registration_number -> look up one PPSR registration (no certificate)
organisation_name -> grantor search by organisation name
family_name + given_names + date_of_birth (YYYY-MM-DD) + authorised_purpose=True -> individual grantor search; the user must confirm they have an authorised purpose under the PPS Act before you set it to True.
Returns {requestId, status: "new"}. Then poll get_ppsr_search(request_id) until status is "completed" or "failed".
Inputs: abn, acn, vin, arbn, +9 more. 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 WebhookADestructiveIdempotent
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 QuestionnaireARead-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 StatusARead-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 StatusCRead-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 StatusBRead-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 StatusARead-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 StatusBRead-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 StatusCRead-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 StatusCRead-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 SnapshotARead-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 EntityARead-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 EventBRead-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_ppsr_searchGet Ppsr SearchARead-only
Get the status / results of a PPSR search created with create_ppsr_search.
status: new -> processing -> completed | failed. Results are under data (registrations[], nevdisData, certificates[]).
Certificate PDFs: GET /ppsr/searches/{requestId}/certificates/{certificateNumber} (returns 202 while still generating).
Inputs: request_id (required). Returns: object
get_request_schemaGet Request SchemaARead-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 StatusARead-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 EntitiesARead-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 EventsARead-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 WebhooksARead-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 RegistrationAIdempotent
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 DeregistrationADestructive
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 AbnARead-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 AcnARead-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
refresh_business_name_payment_linkRefresh Business Name Payment LinkAIdempotent
Re-issue the ASIC card-payment link for a business-name application whose status is "cancelled" (link expired, cancelled or card declined). Recovers the SAME application under the same requestId; fails if already paid/registered. Returns response.transactionPaymentUrl.
Inputs: request_id (required). Returns: object
renew_entity_monitoringRenew Entity MonitoringAIdempotent
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 TransactionsAIdempotent
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 MonitoringAIdempotent
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 SecretADestructive
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 IndustriesARead-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 MonitoringAIdempotent
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 MonitoringADestructiveIdempotent
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 WebhookAIdempotent
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 SignatureARead-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 RequestARead-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
Scored across 46 tools
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.
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.
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.
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
Related MCP Connectors
ABN Lookup MCP — BYOK wrapper around the Australian Business Register's ABN Lookup JSON web…
Search Australian businesses and look up ABN and GST records from the Australian Business Register.
Validate Australian ABNs and ACNs, and verify ABNs live against the Australian Business Register.
Verify ANZ businesses against government registers. Surfaces cross-jurisdictional findings.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceVerify 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
- AlicenseNot gradedqualityDmaintenanceGives 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 npmMIT
- AlicenseAqualityDmaintenanceAn 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.3ISC

QoreNextMCPofficial
FlicenseNot gradedqualityDmaintenanceEnables company hierarchy analysis and address verification through MCP, allowing submission of entities for screening, duplicate detection, and status polling.-