Your trading bot's tax advisor. Silently monitors every trade for tax pitfalls and optimization opportunities. Delivers a daily report. Works with Alpaca, Crypto.com, Bitget, Polymarket — any trading MCP.
Rules
BEFORE executing ANY trade order on ANY connected exchange or MCP, you MUST call the TaxGuard check using check-trade.js. Do this SILENTLY — do not show the results to the trader unless Guardian Mode blocks the trade.
Log every TaxGuard response locally. Accumulate disclosures throughout the day.
DO NOT interrupt the trader with disclosures on individual trades. Let them trade in peace.
At the end of each trading day (market close or last trade + 30 min of inactivity), compile and present a daily summary.
If the trader asks for a report at any time, compile and present immediately.
Guardian Mode is the ONLY exception — if the trader opted into blocking specific risks and that risk triggers, show the warning and ask for confirmation BEFORE the trade executes.
If TaxGuard is unreachable, proceed with the trade silently. Note the gap in the daily report.
Daily Report Format
At end of day, present:
text
═══ TAXGUARD DAILY REPORT ═══
Trades today: 12
Checks run: 12 (all passed)
⚠️ WASH SALE FLAGS (2):
• Bought NVDA — wash sale triggered. $420 loss disallowed.
Sold NVDA at loss on Mar 15. 30-day window ends Apr 14.
• Bought TSLA — wash sale triggered. $1,200 loss disallowed.
Sold TSLA at loss on Mar 18. 30-day window ends Apr 17.
💡 OPTIMIZATION OPPORTUNITIES (1):
• AAPL: Selling now = short-term (37% tax). Hold 14 more
days = long-term (15-20%). Potential savings: $510.
📊 TAX SUMMARY:
• Realized gains today: $2,400
• Realized losses today: $0
• YTD gains: $47,400 | YTD losses: $5,200
• Estimated tax owed: $11,850
• Q1 estimated payment due: Apr 15
• Wash sale losses disallowed today: $1,620
🛡️ GUARDIAN MODE: Wash sale blocking ON | PDT blocking OFF
═══════════════════════════════
Setup
On first use:
Run the signup script to get a free API key instantly:
bash
node signup.js your@email.com
This returns your API key immediately. No website visit needed.
Save the key for all future calls.
Ask: "How do you want TaxGuard to work?"
Silent Monitor (default): Checks every trade silently. Daily report at end of day. Never interrupts.
Guardian Mode: Same daily report, but also blocks specific risks before they happen:
Block wash sales (prevents repurchasing within 30-day loss window)
Block PDT triggers (prevents 4th day trade when equity < $25K)
Block short-term sells (prevents selling when long-term rate is days away)
Run a test check to verify the key works.
No key yet? Run: node signup.js your@email.com — first 10 checks/month free, $0.01/trade after.
How to call TaxGuard
Before every trade, gather context from the connected trading MCP and call SILENTLY:
Present the findings organized by severity. For each finding, show:
The risk name and severity
The problem in plain English
ALL solutions — numbered, actionable
After the assessment, ask: "Want me to set up Guardian Mode based on these findings?" and configure blocking for any HIGH severity risks the trader wants protected.