Lodge Abn Registration
lodge_abn_registrationValidates and lodges Australian Business Number (ABN) applications with the ATO, starting as a dry run by default. Submit entity details, get field errors or a request ID to track.
Instructions
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"request": "<request>"
},
"name": "lodge_abn_registration"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | ||
| request | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||