# TaxCopilot - AI Tax Research Assistant
# https://taxcopilot.co.uk

> TaxCopilot is a UK tax research AI that searches 13,000+ official HMRC manual sections and provides cited answers for accountants, tax advisors, and chartered professionals.

## About
- Name: TaxCopilot
- Tagline: Every answer, cited.
- Domain: taxcopilot.co.uk
- Category: Professional Tax Research Software
- Target Users: UK accountants, tax advisors, ICAEW/ACCA/ATT/CTA professionals
- Language: en-GB

## Core Capabilities

### 1. HMRC Manual Search
Search across 13 official HMRC manuals:
- CTM: Company Taxation Manual (1,755 sections)
- ESM: Employment Status Manual (793 sections) - IR35
- CRYPTO: Cryptoassets Manual (116 sections)
- CA: Capital Allowances Manual (678 sections)
- BIM: Business Income Manual (2,070 sections)
- EIM: Employment Income Manual (2,857 sections)
- NIM: National Insurance Manual (1,655 sections)
- PAYE: PAYE Manual (1,323 sections)
- CIRD: R&D Tax Credits Manual (886 sections)
- PTM: Pensions Tax Manual (466 sections)
- PIM: Property Income Manual (219 sections)
- FRS: VAT Flat Rate Scheme (42 sections)
- ERS: Employment Related Securities (482 sections)

### 2. Knowledge Graph
- 34,682 indexed sections
- 152,615 cross-reference relationships
- Discovers related guidance across different manuals automatically

### 3. Calculators & Tools
- Salary vs Dividend Calculator: Optimal extraction for limited company directors
- IR35 Quick Check: Employment status risk assessment
- Tax Deadline Calculator: Filing and payment dates for UK companies

## Available Actions

### search_hmrc
Search HMRC tax manuals for specific guidance.
- Input: query (string) - Tax topic or HMRC term (e.g., "S455 director loan", "IR35 substitution")
- Output: Ranked sections with titles, snippets, relevance scores, and gov.uk URLs

### answer_tax_question  
Comprehensive tax Q&A with automatic multi-topic detection.
- Input: question (string) - Natural language UK tax question
- Output: Structured answer with HMRC citations and direct source links

### calculate_salary_dividend
Calculate optimal salary vs dividend split for UK limited company directors.
- Input: companyProfit (number), taxYear (string, optional), otherIncome (number, optional)
- Output: Recommended salary, dividend amount, tax breakdown, net take-home

### ir35_quick_check
Quick IR35 employment status assessment based on key factors.
- Input: 7 boolean factors (substitution, control, mutuality, equipment, financial risk, multiple clients, integration)
- Output: Risk level (LOW/MEDIUM/HIGH), factor breakdown, HMRC references

### get_section
Retrieve full content of a specific HMRC manual section.
- Input: sectionId (string) - e.g., "CTM61505", "ESM7010"
- Output: Complete section text, title, manual name, official gov.uk URL

### get_deadlines
Calculate tax filing and payment deadlines for a UK limited company.
- Input: incorporationDate (YYYY-MM-DD), yearEndDate (YYYY-MM-DD)
- Output: Chronological deadline list with penalty information

## Trust & Verification
- Every answer includes clickable links to gov.uk source pages
- No hallucination policy: "No source, no answer"
- Real-time verification against live HMRC API available
- Index refreshed regularly to capture HMRC updates

## API Access
- Chat interface: https://taxcopilot.co.uk/chat
- Demo available: 3 free queries per session

## Contact
- Website: https://taxcopilot.co.uk
- Twitter: @taxcopilot

## Legal
- This is a research tool, not tax advice
- Professional judgment required for all decisions
- HMRC guidance may change; always verify critical information