← All posts

Product update · 4 July 2026

The new ato-mcp: more data, sharper answers, setup in seconds

This is the biggest release since launch. Connecting now takes one line and a browser sign-in, your agent can carry your tax profile into every answer, and underneath it all sits a rebuilt corpus: bigger, cleaner and noticeably better at finding the passage that actually answers the question.

34,564

documents

up from ~29,900

286,638

searchable passages

+37% in one release

64,217

citation links

rulings tied to statute

4,937

public rulings

more than doubled

Setup

One line, a browser window, done

Getting connected used to mean installing an npm package, generating a token on the website and pasting it into a config file. As of this release, tokens are gone entirely.

ato-mcp is now a remote MCP server. Point your agent at one URL and a browser window opens to sign you in, the same OAuth flow you use everywhere else. No tokens to mint, nothing to paste, nothing to rotate. It works in Claude Code, Claude Desktop, Cursor, VS Code and any other MCP host that speaks the protocol. And if your host can't connect remotely, the npm client is still there and now signs you in the same way.

Sign in once and every device picks up where you left off.

Then · three steps

# install, mint a token, paste it in

npx -y ato-mcp

ATO_MCP_TOKEN=atom_•••••••••••••

Now · one step

claude mcp add --transport http ato-mcp \

  https://api.ato-mcp.com.au/mcp

# your browser opens: sign in, approve, done

Personal context

An agent that understands your tax position

Generic tax answers are almost useless. Everything depends on whether you're a sole trader or a company, registered for GST, running a home office. The new facts layer lets you record about 25 of those details once, in a two-minute onboarding.

From then on, every tool call is answered in your context: deduction discovery only surfaces categories that fit how you work, the BAS checklist matches your registrations, and audit risk is scored against your actual profile.

You control every field, and the privacy contract is unchanged: we never store your questions, your results or your documents. The schema has nowhere to put them.

The corpus

Rebuilt from the ground up, and a third bigger

We reworked how the knowledge base is built, end to end: how ATO material is captured, how documents are structured, and how every passage is indexed. The result is a corpus that's not just larger but more faithful to the source: cleaner text, correct headings, and every passage carrying an understanding of where it sits in its document.

That last part matters more than it sounds. A paragraph about “the 50% discount” means something different in a CGT ruling than in a small-business concession guide, and the index now knows the difference.

one release · documents +16% · passages +37%

Rulings coverage more than doubled

From ~2,100 to 4,937 public rulings across ten series (TR, TD, GSTR, PCG and more), with withdrawn rulings clearly flagged so your agent never leans on dead guidance.

The ITAA 1936 and the GST Act join the library

Alongside the ITAA 1997: 6,468 sections of legislation and 2,310 statutory definitions, including the GST Act's s 195-1 dictionary.

Cleaner, better-connected pages

Every ato.gov.au guidance page re-captured with corrected structure and context, and 64,217 citation links tying rulings, guidance and legislation into one graph.

Search quality

Better recall, backed by evaluation, not vibes

The search engine behind every answer was upgraded end to end for this release and re-tuned around how people actually ask Australian tax questions.

Recall and ranking improved measurably across the evaluation suite: the passages your agent needs surface higher, more often, with fewer near-miss results. And because the suite runs as a regression gate, quality can only ratchet upward from here.

Freshness

Rebuilt monthly, served current

The whole corpus now refreshes on a monthly cycle: new and updated ATO material flows in, superseded pages are purged rather than left to go stale, and withdrawn rulings are flagged the moment their status changes. Ask the stats tool and your agent can tell you exactly which snapshot it's reading.

every month, a fresh snapshot

Try the new ato-mcp

One URL, a browser sign-in, and your agent is fluent in Australian tax, with every answer cited.