Skip to main content
Glama

FreelancerTax — Canadian self-employed tax math

instalment_plan

Determine whether a Canadian individual must pay quarterly income-tax instalments (the $3,000 / $1,800-Quebec net-tax-owing tests) and compute all three CRA payment options (no-calculation, prior-year, current-year) as quarterly schedules with a suggested no-interest choice. Per the CRA's instalment calculation chart, 'net tax owing' EXCLUDES CPP contributions and EI premiums payable — pass those separately as cpp_payable and they are added to the instalment amounts only (chart line 24), never to the threshold test.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
quebecNoQuebec resident (lower federal threshold; amounts cover the FEDERAL side only — Revenu Québec runs a separate instalment system, form TP-1026)
cpp_payableNoOPTIONAL: current-year CPP contributions and EI premiums payable on self-employment income, CAD. The CRA chart excludes this from the net-tax-owing threshold test but ADDS it to the instalment amounts (chart line 24). Ignored for Quebec residents — QPP/QPIP are billed by Revenu Québec, not the CRA.
prior_year_owingYesNet tax owing for the prior year, CAD (same chart basis: excludes CPP/EI payable)
current_year_estimateYesEstimated NET TAX OWING for the CURRENT year, CAD — per the CRA calculation chart: income tax minus amounts withheld, EXCLUDING CPP/EI payable on self-employment income (pass those in cpp_payable, do NOT include them here)
second_prior_year_owingYesNet tax owing two years ago, CAD (same chart basis: excludes CPP/EI payable)

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses important behaviors: CPP/EI contributions are excluded from the threshold test but added to instalment amounts, Quebec residents have a separate system, and the tool suggests a no-interest choice. This is transparent about the calculation logic.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is moderately lengthy but well-structured: first sentence captures the main purpose, then details are provided. It earns its place by explaining the threshold test and Quebec-specific notes. Could be slightly more concise, but it's efficient for the complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of 5 parameters and no output schema, the description covers the input logic thoroughly and explains key exclusions. However, it does not describe the return format of the quarterly schedules or the suggested choice, leaving some completeness gap. Still, it is mostly complete for an input-heavy tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The description text largely mirrors the schema descriptions for parameters, adding only the context of the CRA chart exclusion. It does not significantly enhance understanding beyond what the schema already provides, so a 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: determine if a Canadian individual must pay quarterly income-tax instalments using specific CRA tests and compute all three payment options as quarterly schedules. It is specific with verbs ('determine', 'compute') and resources ('quarterly income-tax instalments', 'CRA payment options'), and it distinguishes itself from sibling tools like cpp_self_employed or estimate_self_employed_tax which focus on different aspects.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context on when to use the tool, mentioning the CRA's instalment calculation chart and the distinction for Quebec residents. However, it does not explicitly state when not to use it or suggest alternative tools. The context is strong, but lacking exclusion guidelines.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.1/5.0
Disambiguation5/5

Each tool addresses a distinct aspect of Canadian self-employed tax: CPP contributions, full tax estimate, deadlines, GST registration, GST method comparison, and instalment plans. No overlap in functionality.

Naming Consistency4/5

All names use lowercase with underscores, making them readable. However, they mix verb-noun patterns (e.g., get_tax_deadlines, estimate_self_employed_tax) with noun phrases (cpp_self_employed, instalment_plan), showing minor inconsistency from the ideal verb_noun standard.

Tool Count5/5

Six tools is a well-scoped number for the domain. Each tool serves a necessary function without redundancy, covering major tax obligations for Canadian self-employed individuals.

Completeness4/5

The toolset covers core self-employed tax math: CPP, overall tax estimate, deadlines, GST registration and method comparison, and instalments. Minor gaps exist (e.g., detailed deduction calculators, T2125 support), but agents can work with the provided set.

Resources