Duck Tax
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
Check micro-entity company accounts: raw figures in, validated balance sheet and deadlines out.
| Author | com.ducktax |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 1940 ms |
| Last measured | 2026-10-24 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"Duck Tax": {
"url": "https://ducktax.com/api/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (20)
check_accountsread-onlyDerive a small-company balance sheet (micro-entity, in UK terms) from raw figures and validate it. Returns the derived sheet for the current and prior year, the figures the authority would reject (negatives where it wants a positive, share capital left at nil), and whether they are complete enough to hand to a filing product. It does NOT check that the sheet balances and cannot: retained earnings is derived as the balancing figure, so both sides always agree. Do not tell anybody their sheet was checked for internal consistency. Free and instant: call it after every change to the figures. All money in major units (pounds not pence, dollars not cents). Pass lastFiledAs from lookup_company and it also warns when figures showing activity are about to be filed dormant again.
Parameters:
jurisdiction(required) — string — ISO country code. GB is the only jurisdiction with full support.figures(required) — object — The figures behind a small-company balance sheet. ALL amounts in major units.lastFiledAs— string — What the last accounts were filed as, straight from lookup_company's company.lastAccountsType. Pass it through; do not guess it.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
dormant_figuresread-onlyThe complete set of figures for a dormant company: share capital, the matching cash, and zeros everywhere else. The register says when the last accounts were filed dormant, and for those companies this collapses the whole form to one call. Amounts in major units.
Parameters:
shareCapital(required) — number — Issued share capital in major units. 1 is the overwhelmingly common figure.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
totals_to_figuresread-onlyTurn categorised bank-statement totals into balance sheet figures, applying the rules that stop an import lying: only income categories reach turnover, only expense categories reach operating costs, and the owner topping up the account is never sales. Totals are signed major units per category code; get codes from categorise_transactions.
Parameters:
totals(required) — object — Signed totals per category code, major units, e.g. {"sales": 60000, "software": -1200}.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
late_filing_penaltyread-onlyWhat missing a Companies House accounts deadline costs. Given the due date, returns days remaining or overdue, the penalty band already incurred, and what the next band costs, the number that makes someone act today. UK private companies only.
Parameters:
accountsDue(required) — string — The accounts due date, from lookup_company or a Companies House letter.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
list_jurisdictionsread-onlyThe countries this server knows about and what it can actually do in each: which have a real accounts engine, which registers can be searched or looked up, the currency, and the identifiers each jurisdiction files under. Call this first when unsure.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
sample_accountsread-onlyA real worked example: nil turnover, a director loan, a near-empty bank account, the simplest accounts the UK regime permits. Use it to demonstrate check_accounts or as a template for a first-year company. Amounts in major units.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
lookup_companyread-onlyLook a company up on its public register (Companies House for GB, ABN Lookup for AU) by its registered number. Returns the full public record: name, status, registered office, officers, SIC codes, accounting period, plus both filing deadlines with days remaining and the late-filing penalty already incurred if overdue. Rate limited and quota-charged; cached results are free. Find the number first with search_companies.
Parameters:
jurisdiction(required) — string — ISO country code. Register access exists for GB and AU.companyNumber(required) — string — The register identifier: GB company number (e.g. 15379140) or AU ABN.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
search_companiesread-onlyFind a company by name on its public register and get back its registered number, status and address. This is how you reach lookup_company when the person only knows the name. Free of the daily quota; lightly rate limited.
Parameters:
jurisdiction(required) — string — ISO country code. Register access exists for GB and AU.query(required) — string — The company name, as someone would say it.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
get_prior_year_figuresread-onlyRead last year's figures out of the company's last filed accounts at Companies House, ready to drop into the *Prior fields of check_accounts or save_filing. Saves typing seven numbers from a PDF and gets the comparatives exactly as filed. GB only, and only when the last accounts were filed digitally. Quota-charged; cached results are free.
Parameters:
companyNumber(required) — string — The GB company number.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
explain_accountsread-onlyA plain-English reading of a set of figures, written for a director who is not an accountant: what the derived balance sheet says about the company and anything that needs attention before filing. Only the derived sheet is sent to the model, no company name or number. Quota-charged; identical figures are answered from cache free.
Parameters:
figures(required) — object — The figures behind a small-company balance sheet. ALL amounts in major units.jurisdiction(required) — string — ISO country code. Register access exists for GB and AU.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
categorise_transactionsread-onlyCategorise bank-statement transaction descriptions into the fixed vocabulary this product maps to balance sheet lines (sales, software, owner-in, …). Send description strings only, never amounts or dates. Sum the amounts per returned category yourself, then call totals_to_figures. One statement import is one quota unit; previously seen descriptions are answered from a shared cache free.
Parameters:
tradingType(required) — string — What the company does, to resolve ambiguous merchants. One of: software, consulting, creative, retail, construction, property, hospitality, other. lookup_company suggests one from the SIC codes.descriptions(required) — array — The raw description strings, one per transaction.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
check_filing_extensionread-onlyWhether a company can still apply to its registrar for more time to file, how many days are left to apply, and what being late costs if that window is missed. This is usually the most useful thing to tell somebody who has just found a deadline: applying is free, takes about 15 minutes, and has to be done BEFORE the deadline it extends, so the option expires on the same day the penalty starts. Returns nextAction first. It PREPARES an application and can never submit one: the application is made by a director on the registrar’s own service, which this tool links to. It does not file accounts. Give a company number to read the deadline off the register (quota-charged, cached results free), or give the dates yourself and it costs nothing.
Parameters:
jurisdiction(required) — string — ISO country code. Register access exists for GB and AU.filing(required) — string — Which deadline. Only accounts can be extended; ask about the other and it says so.alreadyExtended(required) — boolean — True if this deadline has been extended once already. Do not guess it, ask.today— string — Defaults to the server's date. Supply it to test a boundary.periodEnd— string — The accounting reference date. Bounds how much extra time could be granted.companyNumber— string — Read the deadline and period end off the register. Omit if you supply the dates.filingDeadline— string — The normal filing deadline, if you already have it. Skips the register request.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
draft_extension_reasonread-onlyTurn a short factual account of what went wrong into the reason text for an application for more time to file accounts, framed in the terms the registrar actually applies. It uses only the facts you give it: it will not invent circumstances, and where something is missing it leaves a bracketed placeholder rather than filling it in. The person must check every sentence before using it, because they are certifying it to the registrar. Ask them what happened, do not supply it yourself. This tool does not submit the application and does not file accounts. Quota-charged as an explanation; identical input is answered from cache free.
Parameters:
jurisdiction(required) — string — ISO country code. Register access exists for GB and AU.circumstances(required) — string — What actually happened, in the person's own words, with dates. Facts only. If you do not have this, ask them for it rather than writing it.expectedReadyBy— string — When they expect the accounts to be ready, if they have said. Never estimate it.whyItStoppedTheAccounts— string — How the event stopped the accounts being prepared, if they have said.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
list_saved_filingsread-onlyThe user's saved filings, most recently touched first, with every figure in major units. This is the same list the website dashboard shows. Start here when asked about "my accounts" or "my company".
Hints: read-only yes · destructive no · idempotent yes · open-world yes
save_filingSave a set of figures to the user's account, or update a saved one by passing its id from list_saved_filings. Figures in major units. The filing is saved even when validation finds problems, because a work in progress is worth keeping, and the problems come back in the response so you can raise them.
Parameters:
jurisdiction(required) — stringfigures(required) — object — The figures behind a small-company balance sheet. ALL amounts in major units.id— integer — Omit to create. Pass an id from list_saved_filings to update that filing.label— string — A name for the filing, e.g. "SparkGames year to 31 Dec 2025".identifiers— object — Register identifiers, e.g. {"companyNumber": "15379140"}. Tax references (UTR, EIN, TFN) are never stored and are silently dropped.categoryTotals— object — Where the figures came from, when a bank statement fed them: signed major-unit totals per category code from categorise_transactions.
Hints: read-only no · destructive no · idempotent yes · open-world yes
delete_filingdestructiveDelete one saved filing by id, permanently. Confirm with the person before calling this; there is no undo and no trash.
Parameters:
id(required) — integer — The id from list_saved_filings.
Hints: read-only no · destructive yes · idempotent yes · open-world yes
track_company_deadlinesWatch a company by its register number and get reminded before its filing deadlines. Which channels are actually available depends on the server: the reply reports what will really be sent, and it can be nothing at all, so read it rather than assuming. No saved filing is needed: this is for the deadline itself, which matters months before any figures exist. Reminders go out on a ladder of days before the deadline (default 90, 60, 30, 14, 7, 1), and each one states the company, the deadline, the date, the days remaining and the penalty for missing it. Calling this again updates the settings and un-mutes a company that was untracked.
Parameters:
jurisdiction(required) — string — ISO country code. Deadline reminders exist where the register publishes deadlines.companyNumber(required) — string — The register identifier: GB company number (e.g. 15379140) or AU ABN.email(required) — boolean — Send reminders to the account email address.push(required) — boolean — Send reminders as web push to signed-in browsers.remindDaysBefore— array — Days before the deadline to warn, e.g. [60, 14, 1]. Omit to use this server’s default ladder. Only the tightest rung that applies is ever sent, so a long ladder does not mean a burst of messages.
Hints: read-only no · destructive no · idempotent yes · open-world yes
list_tracked_companiesread-onlyEvery company this user gets deadline reminders about, including the ones implied by their saved filings. Shows the next accounts deadline and days remaining where a register record is already cached. Free: this never contacts a register.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
untrack_company_deadlinesdestructiveStop sending deadline reminders about a company. This mutes rather than forgets, which is the only thing that holds: a company implied by a saved filing would otherwise be re-added by the next scan. track_company_deadlines un-mutes it again.
Parameters:
jurisdiction(required) — string — ISO country code. Deadline reminders exist where the register publishes deadlines.companyNumber(required) — string — The register identifier, as in track_company_deadlines.
Hints: read-only no · destructive yes · idempotent yes · open-world yes
server_statusread-onlyWhat this deployment can actually do right now: which integrations are configured, whether your token is valid, and how much of each daily quota you have left. Call it when a tool refuses and you want to know whether the feature is off or used up.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.