💰 📄 🏠

“File My Taxes, Maximize Deductions, Handle My Rentals”

One sentence. Six connectors. Every form filled, every deduction found, every dollar accounted for.

See exactly how ContextWeaver replaces TurboTax — from pulling your W-2 to e-filing with the IRS.

First, Let’s Understand What’s Happening

💬 You type one sentence:
“File my taxes. Pull my W-2s, 1099s, rental income, and investment gains. Maximize deductions. File federal and state.”

That’s it. You don’t log into ADP. You don’t download PDFs from your brokerage. You don’t manually enter numbers into TurboTax. You don’t Google “can I deduct my home office?” You just say what you want.

🤖 The AI does 8 things automatically:
💼
1. Pulls your W-2
From your employer’s payroll system (ADP, Gusto, Workday)
🏦
2. Pulls bank interest
1099-INT from your savings & checking accounts via Plaid
📈
3. Pulls stock gains/losses
1099-B, 1099-DIV from Schwab, Fidelity, Robinhood
🏠
4. Pulls rental income
Rent collected, mortgage interest, repairs, depreciation
📖
5. Reads IRS rules
Form instructions, brackets, deduction thresholds from RAG
🧮
6. Calculates deductions
Standard vs. itemized, credits, HSA, student loans
📝
7. Fills all forms
1040, Schedule A/B/C/D/E, state return — every line
📨
8. E-files everything
Federal via IRS MeF + state API, email confirmation
📚 Where do the tax rules come from? (The RAG Filing Cabinet)

The IRS publishes every form, every instruction, every publication — all publicly available. ContextWeaver indexes them into RAG so the AI can read the rules before filling each field.

📄
Step 1: Index
IRS Form 1040 instructions, Publication 17, state tax codes — all chunked, vectorized, and stored in searchable AI indexes
🔍
Step 2: Search
Before filling Schedule D, AI asks: “What are the rules for capital gains?” — finds the exact IRS instructions
Step 3: Apply
Reads: “Long-term gains taxed at 15% if income < $492,300” — applies correct rate to each transaction

Think of it like a smart filing cabinet. The entire U.S. tax code is filed away. Before the AI fills any line on any form, it opens the cabinet, reads the relevant IRS instructions, and follows them. Change the tax law? Update the index. The AI’s behavior changes instantly. No code deployments.

📋 Three layers of context — because taxes are personal

Every tax return is different because everyone’s situation is different. ContextWeaver understands three tiers:

🏢
Company Policies
“401k match: 6% up to $4,500”
“HSA employer contribution: $1,200”
“ESPP discount: 15%”
From your employer’s benefits RAG
👤
Personal Situation
“2 dependents under 17”
“Mortgage interest: $12,400”
“Student loan payments active”
From your connected accounts
🏛️
IRS Rules
“Standard deduction: $14,600”
“Child tax credit: $2,000/child”
“SALT cap: $10,000”
From indexed IRS publications

The AI merges all three layers for your unique return. Your employer’s benefits + your personal life + current tax law = a return that’s optimized for you.

💡 Why this replaces TurboTax

TurboTax is a middleman. It sits between your data and the IRS. You manually enter numbers that already exist in digital systems. Then it charges you $120+/year for the privilege.

TurboTax / H&R Block
  • You download W-2 PDF from ADP → type numbers into TurboTax
  • You download 1099-B from Schwab → type each trade manually
  • You dig up rental receipts → enter expenses one by one
  • You answer 200 interview questions → half don’t apply to you
  • Cost: $120–$220/person/year + state filing fee
ContextWeaver
  • Pulls W-2 directly from ADP API → no manual entry
  • Pulls 1099-B from Schwab via Plaid → every trade, automatically
  • Pulls rental data from property management API → all expenses included
  • Reads IRS rules from RAG → fills only the relevant forms
  • Cost: $0 extra — it’s a connector on the platform you already use

ContextWeaver connects your data sources directly. No middleman. No re-keying numbers. No $120/person/year. The same data flows from ADP → through the AI → onto IRS forms → e-filed. One sentence. Zero screens.

🎯 Putting it all together

When you say “File my taxes”, here’s what happens in about 30 seconds:

  1. The AI reads IRS rules from RAG — finds current brackets, deduction rules, credit thresholds
  2. Pulls your W-2 — wages, withholdings, 401k contributions directly from payroll
  3. Pulls bank interest — 1099-INT from all your accounts via Plaid
  4. Pulls investment data — every stock trade, every dividend, calculates net gains
  5. Pulls rental property data — income, expenses, depreciation, net profit/loss
  6. Optimizes deductions — compares standard vs. itemized, applies credits, finds every dollar
  7. Fills every IRS form — 1040, schedules, state return, all populated
  8. E-files & confirms — submits to IRS + state, emails you the confirmation

One sentence in. Taxes filed, deductions maximized, refund on the way. No screens. No forms. No $120 fee.

The Complete Architecture (Technical View)

Every box below is a real component running in ContextWeaver. Follow the arrows to see how a single sentence becomes a filed tax return.

🧠 AI Hub (User Interface)
User types: “File my taxes. Pull my W-2s, 1099s, rental income, and investment gains. Maximize deductions. File federal and state.”
Authenticated as alice@acme.com • Filing status: Married Filing Jointly • Dependents: 2
🤖 Agent (LLM Orchestrator)
Sees 42 tools from all plugins. LLM decides which tools to call and in what order.
1. Search IRS rules (RAG) 2. Pull W-2 (Payroll) 3. Pull 1099-INT (Banking) 4. Pull 1099-B/DIV (Brokerage) 5. Pull rental data (Real Estate) 6. Calculate & optimize 7. Fill forms (IRS) 8. E-file & email
🔌 MCP Server (Tool Execution Engine)
Single FastMCP instance hosting all plugin tools. Receives tool calls from Agent via Streamable HTTP.
Extracts _user_email=alice@acme.com from every request → per-user credential resolution
Payroll Plugin
ADP, Gusto, Workday
payroll-get-w2 ⬅ used here
payroll-get-paystubs
payroll-get-benefits
Banking Plugin
Plaid → all bank accounts
banking-get-1099-int ⬅ used here
banking-get-balances
banking-get-transactions
Brokerage Plugin
Schwab, Fidelity, Robinhood via Plaid
brokerage-get-1099b ⬅ used here
brokerage-get-1099div ⬅ used here
brokerage-get-cost-basis
brokerage-get-gains-losses
Real Estate Plugin
Property management APIs
realestate-get-rental-income ⬅
realestate-get-expenses ⬅
realestate-get-depreciation ⬅
realestate-get-1099misc
IRS Forms Plugin
Form filling + calculation + e-file
irs-fill-form ⬅ used here
irs-calculate-tax
irs-efile-federal ⬅ used here
irs-efile-state ⬅ used here
Email Plugin
Confirmations & CPA sharing
email-send ⬅ used here
email-attach-pdf
+ 11 more tools
cw-payroll
per-user
Employer payroll API key (ADP, Gusto, Workday)
cw-plaid-banking
per-user
User’s Plaid access tokens for bank accounts
cw-brokerage
per-user
Plaid tokens for Schwab, Fidelity, Robinhood
cw-real-estate
per-user
Property management API credentials
cw-irs-efile
shared
IRS EFIN credentials + MeF e-file gateway
cw-email
per-user
Each user’s own Gmail/Outlook credentials
Vault (Credentials)
👤 cw-pvt-alice-cw-payroll-api-key → Alice’s ADP key
👤 cw-pvt-alice-cw-plaid-access-token → Alice’s Plaid token
👤 cw-pvt-alice-cw-brokerage-token → Schwab via Plaid
🏢 cw-org-cw-irs-efile-efin → IRS EFIN credentials
👤 cw-pvt-alice-cw-email-app-password → Alice’s Gmail
Cascade: User → Group → Org (first found wins)
RAG Indexes (Tax Knowledge)
🏛️ irs-form-1040-instructions → Line-by-line guidance
🏛️ irs-publication-17 → Your Federal Income Tax guide
🏛️ irs-schedules-a-b-c-d-e → Schedule instructions
🏢 employer-benefits-policy → 401k match, HSA, ESPP rules
📍 state-tax-rules-{state} → State-specific rules
Merge: IRS rules (hard law) + employer policies + personal situation = optimized return

Step-by-Step Call Flow (8 Steps)

Step 1 Agent searches RAG for IRS rules
Before doing anything, the agent reads the tax code: “What are the current rules for deductions, credits, and filing?”
search_all(query="1040 instructions tax brackets deduction rules credits filing 2024")
✅ [IRS_1040] “Standard deduction MFJ: $29,200. Itemize if deductions exceed this.”
✅ [IRS_PUB17] “Tax brackets: 10%, 12%, 22%, 24%, 32%, 35%, 37%”
✅ [IRS_SCHED_D] “Long-term capital gains: 0%, 15%, or 20% based on income”
✅ [EMPLOYER] “Acme Corp: 401k match 6%, HSA employer contribution $1,200, ESPP 15% discount”
Step 2 Pull W-2 from ADP via Payroll connector
payroll-get-w2(employer="acme-corp", tax_year=2024, _user_email="alice@acme.com")
→ Connector resolves: Alice’s vault for ADP API key
→ Returns W-2 data:
💵 Wages: $95,000
🏦 Federal tax withheld: $14,250
📊 401k contributions: $12,000 (pre-tax, reduces taxable income)
🏥 HSA contributions: $3,850 (employee) + $1,200 (employer)
Step 3 Pull 1099-INT from Plaid Banking
banking-get-1099-int(tax_year=2024, _user_email="alice@acme.com")
→ Connector resolves: Alice’s Plaid access token from vault
→ Queries all linked bank accounts:
🏦 Chase Savings: $847 interest earned
🏦 Chase Checking: $234 interest earned
→ Total interest income: $1,081 → Goes on Schedule B
Step 4 Pull brokerage data — 1099-B & 1099-DIV
brokerage-get-1099b(tax_year=2024, _user_email="alice@acme.com")
brokerage-get-1099div(tax_year=2024, _user_email="alice@acme.com")
→ Connector resolves: Alice’s Schwab credentials via Plaid
→ Returns all trades and dividends:
📈 Sold AAPL: proceeds $32,400 − cost basis $20,000 = $12,400 long-term gain
📉 Sold TSLA: proceeds $8,800 − cost basis $12,000 = $3,200 short-term loss
💰 Qualified dividends: $1,890 (taxed at capital gains rate)
🧮 Tax-loss harvesting: $12,400 gain − $3,200 loss = net $9,200 capital gain → Schedule D
Step 5 Pull rental property data
realestate-get-rental-income(tax_year=2024, _user_email="alice@acme.com")
realestate-get-expenses(tax_year=2024, _user_email="alice@acme.com")
→ Connector resolves: Alice’s property management API credentials
→ Returns rental property P&L:
🏠 Rental income (12 months)$24,000
  − Mortgage interest($8,400)
  − Property tax($3,600)
  − Repairs & maintenance($2,100)
  − Depreciation (27.5-yr)($5,454)
📊 Net rental income$4,446
→ Goes on Schedule E
Step 6 Calculate & optimize — find every deduction
Agent runs the IRS calculation engine with all data collected, comparing strategies:
📋 Standard vs. Itemized
Standard deduction (MFJ)$29,200
Itemized deductions:
  Mortgage interest (primary)$12,400
  State & local taxes (SALT)$10,000 (capped)
  Charitable donations$3,200
  Medical (above 7.5% AGI)$2,500
Itemized total$28,100
→ Standard deduction wins ($29,200 > $28,100) → take standard
💰 Credits & Above-the-Line Deductions
👶 Child tax credit (2 kids)$4,000
🏥 HSA deduction$3,850
🎓 Student loan interest$1,250
Taxable income after all deductions: $72,127
Federal tax owed: $11,847
Already withheld: $14,250
🎉 Refund: $2,403
Step 7 Generate filled IRS forms
irs-fill-form(forms=["1040","Schedule-B","Schedule-D","Schedule-E","8949"], data={...}, _user_email="alice@acme.com")
📄 Form 1040 📄 Schedule B (Interest & Dividends) 📄 Schedule D (Capital Gains) 📄 Form 8949 (Stock Transactions) 📄 Schedule E (Rental Income) 📄 State Return (MA Form 1)
→ Every line filled using data from Steps 2–6, validated against IRS rules from Step 1
Step 8 E-file via IRS MeF + state API & confirm
irs-efile-federal(return_data={...}, _user_email="alice@acme.com")
irs-efile-state(state="MA", return_data={...}, _user_email="alice@acme.com")
email-send(to="alice@acme.com", subject="✅ Your 2024 Tax Return Has Been Filed")
→ Federal filed via IRS Modernized e-File (MeF) system → Accepted ✅
→ State filed via MA DOR e-file API → Accepted ✅
→ Confirmation email sent with PDF copies → Delivered ✅
→ Return copies stored in vault for records
🤖 Agent Response:
Done! Your 2024 tax return has been filed. Here’s the summary:

💼 Wages: $95,000 (W-2 from Acme Corp via ADP)
🏦 Interest income: $1,081 (Chase Savings + Checking)
📈 Investment gains: $9,200 net (AAPL gain − TSLA loss + $1,890 dividends)
🏠 Rental income: $4,446 net (after expenses & depreciation)
🧮 Deduction: Standard ($29,200) — beat itemized by $1,100
💰 Credits: $4,000 child tax credit + $3,850 HSA + $1,250 student loan

Federal refund: $2,403 (filed via IRS MeF, confirmation #2024-FED-847291)
MA state refund: $387 (filed via MA DOR, confirmation #MA-2024-193847)
📧 Confirmation + PDF copies sent to alice@acme.com

Forms filed: 1040, Schedule B, Schedule D, Form 8949, Schedule E, MA Form 1
Total calls: ~35 • RAG search: 4 • Payroll API: 2 • Plaid Banking: 3 • Brokerage: 4 • Real Estate: 3 • IRS calculation: 2 • Form generation: 6 • E-file: 2 • Email: 1 • Vault lookups: ~8 • Time: ~30 seconds

Same Request, Different People — Different Returns

Four people say “File my taxes.” ContextWeaver pulls different data, applies different rules, and generates different returns for each.

“File my taxes. Maximize deductions. File federal and state.”
👤 Alice Software Engineer • Single • Renter • No investments
Data pulled: W-2 only ($85,000 wages). No 1099s, no rental, no stocks.
Deduction: Standard deduction ($14,600) — no itemization needed
Forms: Just Form 1040 + state return (2 forms total)
Result: ✅ Federal refund: $1,200 — simple return, filed in 8 seconds
👤 Bob Sales Manager • Married • Homeowner + Rental Property
Data pulled: W-2 ($120,000) + rental income ($24,000) + mortgage interest ($18,200) + property taxes ($7,400)
Deduction: Itemized ($31,600 > $29,200 standard) — mortgage interest + SALT cap + charitable
Forms: 1040 + Schedule A + Schedule E + state return (4 forms)
Result: ⚠️ Owes: $890 — rental income pushed him over. Agent suggests increasing Q4 withholding.
👤 Carol Day Trader • Single • 200+ stock trades + crypto
Data pulled: W-2 ($75,000) + 200+ stock transactions + 47 crypto trades + dividends ($3,400)
Optimization: Tax-loss harvesting identified — harvested losses offset $18,400 in gains, saving $4,200 in taxes
Forms: 1040 + Schedule B + Schedule D + Form 8949 (12 pages of trades) + state return
Result: ✅ Federal refund: $3,100 — without tax-loss harvesting, would have owed $1,100
👤 Dave Gig Worker • 1099 Contractor • No W-2 • Home office
Data pulled: No W-2. Multiple 1099-NEC ($92,000 total from 4 clients). Business expenses via banking.
Business deductions: Home office ($3,600), vehicle mileage ($4,200), equipment ($2,800), software ($1,400), internet ($720)
Self-employment: SE tax calculated ($11,680). Quarterly estimated payments already made ($9,200). Half of SE tax deducted above-the-line.
Forms: 1040 + Schedule C + Schedule SE + Form 8829 (Home Office) + state return
Result: ⚠️ Owes: $2,400 — Agent suggests increasing quarterly estimates and recommends Solo 401k for next year.

What ContextWeaver Replaces

Side-by-side comparison: how each approach handles tax filing.

Capability TurboTax H&R Block CPA / Accountant ContextWeaver
Cost per return $89–$219 + $49/state $55–$195 + $49/state $200–$800+ (hourly) $0 — connector on your platform
Data entry method ❌ Manual typing or photo scan ❌ Manual typing or import ❌ You mail/email docs to CPA ✅ Auto-pull from source systems (API)
Deduction optimization ⚠️ Guided interview (200+ questions) ⚠️ Guided interview ✅ Expert judgment ✅ AI reads IRS rules from RAG + calculates every scenario
Multi-source auto-pull ⚠️ Limited imports (some W-2s) ⚠️ Limited imports ❌ You provide everything ✅ W-2 + 1099s + brokerage + rental — all automated
Rental property handling ⚠️ Manual expense entry ⚠️ Manual expense entry ✅ CPA handles ✅ Pulls from property mgmt API + auto-depreciation
Investment / stock trades ⚠️ CSV import (sometimes breaks) ⚠️ CSV import ✅ CPA handles ✅ Direct API pull + tax-loss harvesting optimization
Employer policy awareness ❌ No idea about your company benefits ❌ No idea ⚠️ Only if you tell them ✅ RAG indexes employer 401k, HSA, ESPP policies
Filing method ✅ E-file included ✅ E-file included ✅ E-file or mail ✅ E-file via IRS MeF + state APIs
CPA review option ⚠️ $100+ add-on ⚠️ $50+ add-on ✅ Built-in (that’s what they do) ✅ Email plugin shares return with your CPA for review
Data security ⚠️ Stores your SSN + all data ⚠️ Stores your SSN + all data ⚠️ Varies by firm ✅ Data stays in source systems. Vault-backed credentials. AI never sees secrets.
Time to complete 2–5 hours (complex return) 2–5 hours 1–3 weeks (back and forth) 30 seconds

The Bigger Picture: A Lego System for Financial Services

🧱 Every connector is a building block. Snap them together to build anything.

The tax filing example above used 6 connectors (Payroll + Banking + Brokerage + Real Estate + IRS + Email). But ContextWeaver isn’t a tax app — it’s a platform for building any financial service by combining connectors like Lego blocks:

💰
Tax Filing
Payroll + Banking + Brokerage
+ Real Estate + IRS + Email
= This page
📊
Financial Planning
Banking + Brokerage + Insurance
+ Advisor API
= AI wealth advisor
🏠
Rental Management
Real Estate + Banking
+ Email + Calendar
= AI landlord assistant
🧾
Expense Reports
Receipt Scanner + Banking
+ Accounting + Email
= AI expense manager
🔌 Same connectors, different combinations — unlimited financial services
🧱 Connectors Used in Tax Filing
cw-payroll cw-plaid-banking cw-brokerage cw-real-estate cw-irs-efile cw-email
🔄 Re-use in Other Services
cw-plaid-banking also powers: budgeting, bill pay, fraud alerts
cw-brokerage also powers: portfolio rebalancing, smart trading
cw-real-estate also powers: tenant screening, maintenance requests
cw-payroll also powers: HR onboarding, benefits enrollment

🧱 Build once. Combine infinitely. — One platform, every financial service.

Tax filing is just one combination of connectors. The same building blocks power financial planning, rental management, expense reports, and anything else you can imagine. Add a connector — unlock a new service.

“But My Financial Data Is Sensitive!” — Security Deep Dive

Tax returns contain the most sensitive data there is — SSNs, income, bank accounts, investment positions. Here’s how ContextWeaver protects it all.

🔒 The AI never sees your secrets

The LLM orchestrates actions but never touches raw credentials or sensitive identifiers.

What the AI NEVER sees
  • Your Social Security Number (SSN)
  • Bank account numbers or routing numbers
  • Brokerage account credentials
  • Plaid access tokens or API keys
  • IRS EFIN credentials or e-file passwords
  • Any vault secret values
What actually happens
  • LLM says: “call payroll-get-w2”
  • Engine resolves ADP key from vault at runtime
  • Engine calls ADP API directly — key in memory for milliseconds
  • LLM sees only: “Wages: $95,000, Withheld: $14,250”
  • SSN is injected into IRS forms by the engine, never passed to LLM
  • E-file credentials are used by the engine, never exposed

Think of it this way: the AI is like a tax preparer who can read your pay stubs but never learns your Social Security Number. The engine handles the sensitive parts. The AI handles the intelligence.

🏦 Data stays in source systems — not in ContextWeaver

Unlike TurboTax, ContextWeaver doesn’t create a copy of your financial life.

💼
W-2 Data
Stays in ADP/Gusto. Pulled via API at filing time. Not stored.
📈
Brokerage Data
Stays in Schwab/Fidelity. Pulled via Plaid at filing time. Not stored.
🏠
Rental Data
Stays in property mgmt system. Pulled via API at filing time. Not stored.

Key principle: ContextWeaver is a conductor, not a warehouse. It orchestrates data flow between your existing systems and the IRS. Your data stays where it already is — in the systems designed to protect it. After filing, only the IRS confirmation number is retained.

🗄️ Vault-backed credential isolation

Every user’s financial credentials are isolated in their own vault partition.

CredentialStorageEncryptionAccess
Plaid access tokensAzure Key Vault (user partition)AES-256 + HSMOnly your requests
Payroll API keysAzure Key Vault (user partition)AES-256 + HSMOnly your requests
Brokerage tokensAzure Key Vault (user partition)AES-256 + HSMOnly your requests
IRS EFIN credentialsAzure Key Vault (org partition)AES-256 + HSMShared — org-level e-file authority
SSN (for e-filing)Azure Key Vault (user partition)AES-256 + HSMOnly injected into forms by engine

Alice’s Plaid token can never be used by Bob. Bob’s brokerage credentials can never be seen by Carol. Every credential is per-user, encrypted, and ephemeral — resolved at runtime, used once, discarded.

🔒 Financial Data Security in One Picture
🧠 AI (LLM)
Sees: dollar amounts
Never sees: SSN, keys, tokens
🔌 Engine
Resolves credentials
Injects SSN into forms
🗄️ Vault
Encrypted per-user
Azure KV / HSM-backed
🏛️ IRS MeF
Federal e-file gateway
End-to-end encrypted

Your financial data never lives in ContextWeaver. It flows from source systems → through the engine → to the IRS. The AI orchestrates but never holds sensitive data.

The Bottom Line

One sentence. Six connectors. Every W-2 pulled. Every 1099 imported. Every deduction found.
The AI read IRS rules, pulled your data from 4 systems, optimized your deductions,
filled 6 forms, e-filed federal & state, and emailed your confirmation.
No screens. No interview. No $120 fee. No re-keying numbers.

And this is just one combination of connectors. The same building blocks power
financial planning, rental management, expense reports, and any other service.
ContextWeaver replaces TurboTax, H&R Block, and manual data entry
with one sentence and 30 seconds of AI-powered automation.

© 2026 ContextWeaver — Enterprise RAG & Agentic AI Platform