Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Alberta Tax Agent what are the upcoming GST/HST filing deadlines?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Claude MCP plugin that brings the working knowledge of an Alberta tax accounting and law firm into your editor. 47 tools across 10 domains, plus a self-learning layer that lets the agent absorb new rates, rules, and corrections over time.
Corporate Tax (4 tools). T2/AT1 calculations, SBD, instalments, rate references.
GST/HST (4 tools). Registration assessment, Quick Method comparison, ITC eligibility.
Payroll (4 tools). CPP/EI/tax deductions, remittance schedules, WCB premiums.
Tax Planning (5 tools). Salary vs dividend, Holdco analysis, estate freezes, income splitting, LCGE qualification.
Deductions & Credits (5 tools). CCA, SR&ED, vehicle expense, home office.
Compliance & Audit (6 tools). Risk assessment, late penalties, voluntary disclosures, director liability, dispute roadmap.
International Tax (4 tools). Treaty rates, cross-border transactions, foreign tax credits.
Business Structure (3 tools). Entity comparison, asset vs share sale, reorganizations.
Deadlines & Calendar (3 tools). Upcoming deadlines, filing calendar, year-end checklist.
Self-Learning (9 tools). Knowledge updates, research logging, correction tracking, insight capture, dynamic rate overrides.
Full tool listing in CLAUDE.md.
Related MCP server: qb-mcp
npm install
npm run buildclaude mcp add alberta-tax-agent node /absolute/path/to/alberta-tax-agent/build/index.jsAdd to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"alberta-tax-agent": {
"command": "node",
"args": ["/absolute/path/to/alberta-tax-agent/build/index.js"]
}
}
}npm run inspectTax software treats the Income Tax Act as a black box and gives you numbers. A tax-aware agent treats it as queryable knowledge and gives you reasoning. The difference matters most when the right answer depends on facts the form doesn't ask for: a Holdco that may or may not earn its keep, an SR&ED claim whose proxy method changes the math, a cross-border payment whose treaty rate beats the statutory withholding.
The self-learning layer exists because tax law changes. Static rate tables go stale within a year. The dynamic rate overlay lets the agent absorb corrections without a code change.
Informational analysis only. Not professional tax advice. Verify against current CRA and Alberta TRA publications and consult a qualified CPA or tax lawyer before making decisions with real money attached.
MIT
Add an owner, shareholder, or partner to the business profile. I need this for salary/dividend planning, income splitting analysis, and LCGE planning.
Inputs: name (required), ownership_percent (required), role, annual_salary, +3 more.
See all my notes, reminders, and action items for your business. These are things I've flagged that need your attention.
Inputs: show_resolved.
Assess your business's risk of being selected for a CRA audit based on common triggers and red flags. Provides a risk score and mitigation recommendations.
Inputs: industry (required), expense_ratio (required), annual_revenue (required), reported_net_income (required), +8 more.
Calculate the adjusted Small Business Deduction business limit after taxable capital and passive income clawbacks.
Inputs: passive_income (required), taxable_capital (required), associated_group_limit.
Calculate CCA (depreciation) for a capital asset. Supports all CCA classes, half-year rule, and Accelerated Investment Incentive.
Inputs: cost (required), cca_class (required), is_first_year, years_to_project, +2 more.
Calculate combined federal + Alberta corporate income tax for a CCPC or other corporation. Handles SBD, general rate, investment income, passive income grind, and taxable capital clawback.
Inputs: active_business_income (required), is_ccpc, taxable_capital, investment_income, +2 more.
Calculate GST on a transaction. Can work from GST-exclusive or GST-inclusive amounts. Alberta rate is 5% (no PST/HST).
Inputs: amount (required), is_inclusive.
Calculate the business deduction for using a home office. Covers both self-employed and corporate scenarios.
Inputs: office_sqft (required), total_home_sqft (required), annual_rent, annual_internet, +7 more.
Calculate monthly/quarterly corporate tax instalment amounts using the current-year, prior-year, or combination method.
Inputs: prior_year_tax (required), current_year_estimated_tax (required), is_small_ccpc, second_prior_year_tax.
Calculate CRA penalties and estimated interest for late filing of T2, AT1, or GST returns.
Inputs: unpaid_tax (required), months_late (required), return_type, is_repeat_offender, +1 more.
Calculate CPP, EI, federal and Alberta income tax deductions for an employee. Shows both employee deductions and employer costs.
Inputs: gross_pay (required), annual_salary, pay_frequency, td1_claim_code.
Calculate federal and Alberta SR&ED (Scientific Research and Experimental Development) tax credits. Covers enhanced CCPC rate, basic rate, proxy method, and Alberta IEG.
Inputs: salary_base (required), qualifying_expenditures (required), is_ccpc, taxable_capital, +2 more.
Calculate deductible vehicle expenses for business use. Handles CCA, standby charges, operating benefits, and per-km allowances.
Inputs: vehicle_cost (required), total_km_driven (required), business_km_driven (required), fuel_cost, +7 more.
Find the correct CCA class for a capital asset. Search by asset type or browse all classes.
Inputs: search_term.
Show the chart of accounts used for bookkeeping. These map your transactions to the correct CRA tax lines.
Inputs: type_filter.
Display current federal and Alberta corporate tax rates, including combined rates for small business and general income.
Inputs: no named parameters.
Analyze the tax implications of a cross-border transaction between a Canadian company and a foreign entity. Covers withholding tax, transfer pricing, thin cap, and treaty benefits.
Inputs: amount (required), country_code (required), transaction_type (required), is_related_party, +1 more.
Assess personal liability exposure for corporate directors under Section 227.1 (ITA) and Section 323 (ETA). Covers unremitted source deductions, GST, and due diligence defence.
Inputs: has_resigned, unremitted_gst, resignation_date, is_inside_director, +3 more.
Step-by-step guide to disputing a CRA assessment — from Notice of Objection through Tax Court of Canada and beyond.
Inputs: tax_type (required), dispute_amount (required), days_since_assessment (required).
Complete checklist of annual employer obligations for Alberta businesses — T4s, ROEs, WCB, and more.
Inputs: no named parameters.
Compare sole proprietorship, partnership, and corporation for a business in Alberta. Factors in tax rates, liability, compliance costs, and planning opportunities.
Inputs: expected_annual_income (required), personal_spending_needs (required), num_owners, has_employees, +2 more.
Plan an estate freeze to lock the current owner's value and shift future growth to the next generation. Covers Section 86 share exchange and Section 85 rollover methods.
Inputs: current_fmv (required), acb_of_shares (required), use_family_trust, num_beneficiaries, +2 more.
Display the complete annual tax filing calendar for Alberta businesses — all deadlines organized by category.
Inputs: category.
See what's been filed, what's pending, and what's overdue. Your accountant's status board.
Inputs: fiscal_year.
See your income statement, balance overview, and GST position for the fiscal year. This is your bookkeeping dashboard — where your money is going.
Inputs: quarter, fiscal_year.
Calculate the available foreign tax credit under Section 126 for business income or non-business (investment) income from a foreign country.
Inputs: income_type (required), country_code (required), foreign_income (required), foreign_tax_paid (required), +2 more.
Show the currently effective tax rates, including any overrides from the learning system. Highlights where the agent is using updated values vs the original hardcoded defaults. Use this to verify what rates the agent is actually using for calculations.
Inputs: category.
Compare the Quick Method of accounting vs. regular GST method. Shows potential savings. Available for businesses with annual taxable supplies up to $400,000.
Inputs: annual_gst_inclusive_revenue (required), annual_gst_paid_on_purchases (required), is_reseller.
Determine if GST registration is required and the optimal filing frequency based on your revenue level.
Inputs: annual_taxable_supplies (required), is_taxi_rideshare, quarterly_revenue_highest.
Analyze whether a holding company (Holdco) structure would benefit your business. Covers creditor protection, tax-deferred surplus extraction, passive income management, and estate planning.
Inputs: annual_active_income (required), annual_surplus_retained (required), planning_for_sale, has_high_liability_risk, +2 more.
Import transactions from a CSV file — bank statement export, credit card statement, or your own expense spreadsheet. I'll auto-detect the columns, categorize each transaction, and calculate GST. Supports exports from ATB, TD, RBC, BMO, and generic formats.
Inputs: file_path (required), date_column, account_type, amount_column, +3 more.
Read a PDF invoice or receipt and extract the transaction data. I'll pull out the vendor, date, amounts, line items, and GST — then record it as a transaction. Works with invoices, receipts, statements, and bills.
Inputs: file_path (required), extracted_data (required), document_type.
Import from your own expense tracking spreadsheet (CSV format). Flexible column mapping — tell me which columns hold the date, description, amount, category, and I'll do the rest. Perfect for the messy spreadsheet you've been keeping.
Inputs: file_path (required), column_mapping (required), has_header_row.
Analyze income splitting opportunities considering Tax on Split Income (TOSI) rules. Identifies which strategies are available based on family members' ages and involvement.
Inputs: family_members (required), over_90pct_service_income, corporation_is_professional.
Determine if a purchase qualifies for an Input Tax Credit (ITC) and any restrictions that apply.
Inputs: amount (required), expense_type (required), business_use_percent, annual_taxable_supplies.
Determine if corporation shares qualify for the Lifetime Capital Gains Exemption ($1,016,836 for QSBC shares). Checks the 90% test, 50%/24-month test, and CCPC status.
Inputs: expected_gain (required), total_assets_fmv (required), passive_investments_fmv (required), active_business_assets_fmv (required), +4 more.
Record when a calculation, rate, or rule was found to be incorrect. Optionally creates a knowledge override to fix it going forward. Use this whenever you find a mistake in the agent's output or when a user points out an error.
Inputs: source (required), tool_name (required), description (required), correct_value (required), +4 more.
Record findings from tax research. Use this whenever you investigate a tax topic, look up a rule, or explore how something works. Builds a searchable knowledge base of everything the agent has researched. Examples: researching SR&ED eligibility for a specific activity, looking up treaty rates for a new country, investigating CCA class for a novel asset type.
Inputs: topic (required), sources (required), findings (required), question (required), +3 more.
Record what was learned while performing a task. Use this to track gaps in the agent's capabilities, scenarios it hasn't handled well, or patterns it should recognize in the future. These insights drive improvements. Examples: 'partnership allocation not supported', 'need to handle non-calendar FYE for instalments'.
Inputs: insight (required), outcome (required), scenario (required), tool_name (required), +3 more.
Add or toggle a custom tax rule that the agent should apply. Custom rules capture interpretations, special scenarios, or business-specific policies that aren't in the standard knowledge base. Examples: 'Always apply the vehicle standby charge reduction for this client', 'Partnership uses 50/50 allocation instead of ownership %'.
Inputs: action (required), name, source, rule_id, +4 more.
Mark a tax return as filed. Updates your filing status tracker.
Inputs: filed_date (required), return_type (required), period, confirmation_number.
Show all transactions that are missing receipts. CRA can deny deductions without proper documentation.
Inputs: fiscal_year.
Determine the employer's payroll remittance frequency and due dates based on average monthly withholding amounts.
Inputs: average_monthly_withholding (required), is_new_employer, has_perfect_compliance.
Compile GST collected and ITCs paid from your transactions into a GST return worksheet. Shows exactly what to report on your GST return.
Inputs: period (required).
Compile your bookkeeping data into a T2 corporate income tax return worksheet. This generates the numbers your accountant (or you) need to file with CRA. Reviews all transactions, applies tax adjustments, and calculates tax owing.
Inputs: fiscal_year, additional_adjustments.
Record multiple transactions at once. Great for entering a batch of receipts or a month's worth of bank statement entries. Give me a list and I'll categorize them all.
Inputs: transactions (required).
Comprehensive guide to CRA and Alberta TRA record keeping requirements — what to keep, how long, and in what format.
Inputs: business_type, has_employees, has_gst_registration, has_international_operations.
Record a transaction from a receipt photo (PNG, JPG, JPEG). Claude reads the image, you provide the extracted details, and I'll create the transaction with the image linked as proof. This is how you digitize paper receipts.
Inputs: date (required), total (required), vendor (required), image_path (required), +7 more.
Record a business expense or income. Tell me what you bought/earned, from whom, how much, and when. I'll categorize it, calculate GST, and file it properly. This is how you feed me your receipts and invoices.
Inputs: date (required), amount (required), description (required), notes, +6 more.
Guidance on corporate reorganizations — amalgamation (s.87), wind-up (s.88), butterfly transactions (s.55), and rollover provisions. Identifies the right structure for your situation.
Inputs: scenario (required), has_tax_losses, has_real_estate, num_corporations.
Mark a task insight as resolved after the gap has been addressed or the improvement has been implemented.
Inputs: insight_id (required).
Mark an advisor note/action item as resolved.
Inputs: note_id (required).
See everything the agent has learned: knowledge updates, research findings, corrections, unresolved gaps, custom rules, and usage stats. Use this to understand how the agent has evolved and what still needs attention.
Inputs: search, section_filter.
Compare the total tax cost of extracting corporate income as salary, eligible dividends, or non-eligible dividends. Accounts for CPP/EI, RRSP room, and integration imperfections.
Inputs: corporate_income (required), needs_rrsp_room, needs_cpp_benefits, other_personal_income.
List all receipt images in a folder that haven't been processed yet. Useful when you dump a bunch of receipt photos into a folder and want to go through them. Returns the list so Claude can read each image and call record_receipt for each one.
Inputs: folder_path (required).
Set up the business profile. This is the first step — tell me about your business so I can be your in-house tax accountant. I'll remember everything for future sessions.
Inputs: industry (required), legal_name (required), description (required), business_name (required), +9 more.
Run a comprehensive review of your business's tax situation. I'll check your records, flag problems, and tell you exactly what needs attention — like a quarterly meeting with your accountant.
Inputs: fiscal_year.
Record that a tool was used for a specific scenario. Builds usage analytics so the agent can identify which tools are most valuable and what patterns recur. This is typically called automatically but can be used manually.
Inputs: tool_name (required), input_pattern.
Look up Canada's tax treaty withholding rates for a specific country. Shows rates for dividends, interest, royalties, and management fees.
Inputs: country_code (required), payment_type.
Display withholding tax rates for all countries in Canada's tax treaty network (major trading partners).
Inputs: no named parameters.
Show all upcoming tax filing and payment deadlines based on your fiscal year-end. Alerts you to deadlines within a specified window.
Inputs: fiscal_year_end (required), days_ahead.
Update a tax rate, threshold, rule, or any other knowledge entry. Use this when you discover that a rate has changed, a new rule applies, or the current knowledge is outdated. The update is stored as an override — the original hardcoded value is preserved as a fallback. Examples: update GST rate, change SBD limit, add a new CCA class threshold, update a treaty withholding rate.
Inputs: key (required), source (required), category (required), new_value (required), +5 more.
Update a field on the business profile. Use this when you get new information like your Business Number, GST registration, or payroll details.
Inputs: field (required), value (required).
Show the current business profile and setup status. See what I know about your business and what's still missing.
Inputs: no named parameters.
Guide to CRA's Voluntary Disclosure Program for correcting past tax errors or omissions before CRA contacts you. Covers both General and Limited tracks.
Inputs: type_of_issue (required), number_of_years (required), estimated_unreported_income (required), has_cra_contacted, +1 more.
Based on your specific business, I'll tell you exactly what records and documents you need to keep. No generic advice — this is tailored to YOUR situation.
Inputs: no named parameters.
Comprehensive year-end tax planning checklist for Alberta businesses. What to do before your fiscal year-end to minimize taxes.
Inputs: fiscal_year_end (required), estimated_income (required), is_ccpc, has_employees, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 69 tools
Several tools have overlapping boundaries, such as the multiple logging tools (log_research, log_correction, log_task_insight) and multiple status/planning tools (tax_health_check, advisor_notes, filing_status). With 69 tools, even well-described tools become hard to distinguish, and some pairs like treaty_rate_lookup vs treaty_rates_table or holding_company_analysis vs reorganization_advisor require careful reading.
Naming conventions are inconsistent, mixing verb_noun (record_transaction, calculate_corporate_tax), noun phrases (filing_status, corporate_tax_rates), and even full sentences (what_records_do_i_need). Some tools use adjectives (financial_summary) and others use acronyms (CCA, SR&ED) without a consistent pattern.
With 69 tools, this server is far beyond the typical scope for an MCP server. The sheer number overwhelms an agent's selection capabilities and suggests many tools could be consolidated or removed. Even complex domains like tax rarely require 69 discrete tools.
The tool surface comprehensively covers the domain of Alberta business tax: setup, bookkeeping, imports, GST, payroll, corporate tax, compliance, planning, and a learning system. There are no obvious dead ends for core workflows, and even meta-tools for tracking knowledge gaps are included.
Hybrid human + AI expertise for faster, trusted answers and decisions via MCP Server.
Remote MCP server exposing 330 production AI-agent services for web/data processing, validation, AI utilities, blockchain/crypto utilities, and x402 pay-per-use access.
B2B, GovCon & LegalTech MCP server for live RFPs, contract parsing, compliance & proposal tools.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
