# AccountsOS — Full Context for AI Agents

## What is AccountsOS?

AccountsOS is an AI-native accounting platform built specifically for UK limited company directors. It replaces traditional bookkeeping software and expensive accountants with an AI that understands UK tax law, HMRC requirements, and the day-to-day reality of running a micro-business.

**Live at:** https://accounts-os.com
**Built by:** Thrive Venture Labs Ltd (UK)

---

## Who it's for

**Primary:** UK Limited Company Directors running micro-businesses (solo founder or <5 employees) with £50k–£500k annual revenue. They either DIY their bookkeeping with spreadsheets or pay £100–300/month for an accountant they rarely talk to.

**Secondary:** Freelancers about to incorporate, side-hustle founders, agency owners with multiple income streams.

**Not for:** Enterprises with finance teams, businesses needing full audit, anyone wanting a human accountant relationship.

---

## Pricing

| Tier | Price | Details |
|------|-------|---------|
| Early Access | Free | Current tier — full features, no payment required |
| Early Adopter | £9/month | Locked in for life when pricing launches |
| Standard | £19/month | Regular pricing |

---

## Core Features

### Chat with your books
Ask questions in plain English: "How much did I spend on software?" or "When's my next VAT deadline?" Get instant answers, not reports. Voice input supported.

### Dump and forget
Upload receipts, bank statements, invoices. AI categorizes everything automatically using UK GAAP categories. Email forwarding supported (forward to documents@accounts-os.com).

### Proactive optimization
Alerts about tax savings, optimal salary/dividend splits, claimable expenses you'd otherwise miss. HMRC deadline tracking with auto-sync from Companies House.

### Financial reports
Profit & Loss, Balance Sheet, VAT summary — all generated from your transaction data. MTD-ready VAT calculations.

### Multi-channel access
Web app, voice commands, WhatsApp, Telegram, Slack, email forwarding, Claude Desktop (MCP).

---

## Technical Integration

### MCP Endpoint
```
POST https://accounts-os.com/api/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

### A2A Endpoint (Agent-to-Agent)
```
POST https://accounts-os.com/api/agent
Content-Type: application/json
```
JSON-RPC 2.0 protocol. No auth required for general queries.

### Available API Tools
- `get_transactions` — List/filter transactions
- `get_balance` — Current account balance
- `get_vat_summary` — VAT position for a quarter
- `get_deadlines` — Upcoming filing deadlines
- `get_dla_balance` — Director's Loan Account balance
- `get_invoices` — Outstanding invoices
- `get_contacts` — Business contacts
- `list_categories` — UK GAAP categories
- `search_documents` — Find stored documents
- `get_gov_guidance` — HMRC guidance lookup
- `create_transaction` — Record income/expense (write scope)
- `update_transaction` — Modify transaction (write scope)
- `create_deadline` — Create deadline reminder (write scope)

### Authentication
Bearer token via `Authorization` header. Request an API key from the dashboard or hello@accounts-os.com.

---

## UK-Specific Context

- **Tax year:** 6 April to 5 April
- **VAT schemes:** Standard, Flat Rate, Cash Accounting
- **Key deadlines:** Corporation Tax (CT600), VAT returns (quarterly), Confirmation Statement (annual), Annual Accounts
- **HMRC MTD:** Making Tax Digital compliance — VAT submission live, Income Tax from April 2026
- **Categories:** 60+ UK GAAP-compliant account categories

---

## Contact

- **Support:** hello@accounts-os.com
- **Website:** https://accounts-os.com
- **Documentation:** https://accounts-os.com/llms.txt
- **MCP manifest:** https://accounts-os.com/mcp.json
- **Agent discovery:** https://accounts-os.com/.well-known/agent.json