Agent-ready infrastructure for Canadian T1 tax workflows
Blackspark builds Armada, a Canadian T1 automation platform that lets AI agents gather taxpayer information, create structured tax records, trigger follow-up tasks, prepare review packages, and support professional review.
Use Armada Gather with your existing EFILE software, or use Armada EFILE Mode for the full workflow including AFR, T183, and EFILE through Armada.
Tax software is changing
Tax software was built for humans clicking through screens.
AI agents need something different: a structured tax backend they can safely operate.
Armada exposes Canadian T1 clients, tax files, sections, required fields, validation rules, tasks, review states, and filing-mode boundaries through agent-ready APIs and MCP tools.
Agents operate. Armada governs. Professionals approve.
What agents can do with Armada
-
External agents can help collect and organize information that taxpayers provide to the firm outside of CRA systems.
This can include uploaded PDFs, scanned slips, photos of receipts, spreadsheets, working papers, email attachments, client notes, questionnaire responses, and preparer interview notes. The agent can use its own LLM or document-processing tools to interpret the material, then use Armada to determine where the information belongs in the tax file.
This is especially useful for information that may not be available from CRA AFR, such as donation receipts, medical expenses, self-employment income and expenses, business-use-of-home details, vehicle expenses, rental-property details, childcare information, or supporting documents for claims.
Result: Client-provided tax information becomes structured, reviewable tax-file data instead of remaining scattered across emails, folders, PDFs, and spreadsheets.
-
Agents do not need to guess how a Canadian T1 tax file is structured. They can ask Armada which sections exist for a given tax file and what each section requires.
For example, an agent can discover sections such as T4 slips, T5 slips, RRSP contributions, donations, medical expenses, child care expenses, self-employment/T2125, rental income, tuition, dependants, pension income, and other relevant areas.
For each section, Armada can expose the available fields, required fields, field types, allowed values, validation rules, whether multiple records are supported, and whether the section requires professional review.
Result: The agent works from Armada’s valid tax-file structure instead of inventing fields, categories, or workflows.
-
Once an agent understands the relevant section and required fields, it can create structured records in Armada.
For example, if a taxpayer uploads three donation receipts, the agent can create three donation records. If a taxpayer uploads a T4, the agent can create a T4 instance. If the taxpayer provides a self-employment working paper, the agent can create or update the relevant self-employment/T2125 records.
These records can include source references, validation status, and review status, so the firm can trace where the information came from and decide whether it is ready to use.
The important point is that the agent is not merely summarizing documents. It is converting taxpayer-provided information into structured, reviewable tax-file data.
Result: Staff review organized tax records instead of re-entering information from loose notes, PDFs, spreadsheets, and emails.
-
Armada can help agents identify incomplete, inconsistent, or questionable tax-file sections and turn those issues into actionable follow-up tasks.
For example, if a donation receipt is missing the eligible amount, the agent can create a task to request clarification. If a self-employment working paper indicates business-use-of-home expenses but lacks square footage details, the agent can create a follow-up task. If the client mentions moving during the year but does not confirm province of residence on December 31, the agent can create a task for staff or the client.
Tasks can be assigned, tracked, and tied to the specific section or record that caused the issue.
Result: Missing information becomes a managed workflow instead of a last-minute surprise buried in an email thread.
-
Agents can use Armada’s structured tax-file data to prepare concise summaries for preparers, reviewers, or managers.
A reviewer-ready summary can show what documents were received, what records were created, which fields were changed, which items came from taxpayer-provided documents, which items still need review, what validation warnings exist, what tasks remain open, and whether any duplicate or unusual items were flagged.
This is especially useful before senior review, because the reviewer does not have to reconstruct the file history manually.
Result: The file reaches the reviewer with a clear summary of what changed, what is missing, what needs judgment, and what is ready to proceed.
-
For firms that want to keep their current EFILE software, Armada can act as the structured front-end data gathering and task automation layer.
After the agent gathers data, creates records, validates sections, and resolves or tracks missing items, it can generate a handoff package for the firm’s existing tax software workflow.
That package could include section-by-section data tables, document indexes, source references, validation warnings, open tasks, reviewer notes, and summaries that help staff enter or import the data into their existing EFILE software.
This allows the firm to benefit from agentic data gathering without immediately replacing the software it already trusts for final preparation and filing.
Result: Firms can keep their existing EFILE software while using Armada to organize, validate, and prepare the data before the return gets there.
-
When the firm chooses Armada as the EFILE software of record for a particular return, Armada can support the full agent-ready filing workflow.
In this mode, Armada can use AFR to gather CRA-held taxpayer data, reconcile CRA information with taxpayer-provided documents, prepare the return, support the T183 signature workflow, monitor EFILE readiness, and electronically file the return through Armada.
This mode is subject to an important compliance boundary: AFR is not available as a standalone data-gathering tool when the return will be filed using separate EFILE software. AFR is available only when the return is intended to be filed through Armada’s certified EFILE workflow.
Result: Firms can start with agentic front-end data gathering and task automation, then deploy agents to perform the full AFR-to-EFILE workflow when Armada is the intended filing software.