# AccountsOS - AI Accounting for UK Businesses
# https://accounts-os.com/llms.txt

> AI-native accounting. Let your agent run the books.

## What this site does
- Track business transactions (income/expenses)
- Calculate and manage VAT returns
- Monitor filing deadlines (CT600, VAT, Confirmation Statement)
- AI-powered transaction categorization
- Document storage and search
- UK Ltd companies and sole traders

## For AI Agents
This site is agent-ready. Skip the UI and use the API directly.

- CLI (recommended for agents that can shell out): `curl -fsSL https://accounts-os.com/install.sh | bash` — landing at /for-agents
- npm package: `@thriveventurelabs/accountsos` (binary: `accountsos`)
- MCP server (Claude Desktop): `@thriveventurelabs/accountsos-mcp`
- Skill documentation: /skill.md
- A2A endpoint: /api/agent (JSON-RPC 2.0)
- REST API: /api/mcp (Bearer auth)
- Self-signup: POST /api/agent-signup — agent gets API key instantly
- No browser automation needed
- Claude Cowork plugin: github.com/paulgosnell/accountsos-cowork-plugin (6 commands, 4 skill packs)

## Quick Start
```bash
# Get recent transactions
curl -X POST https://accounts-os.com/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "tool", "name": "get_transactions", "arguments": {"limit": 10}}'

# Create a transaction
curl -X POST https://accounts-os.com/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "tool",
    "name": "create_transaction",
    "arguments": {
      "date": "2026-02-01",
      "description": "Client invoice payment",
      "amount": 1500.00,
      "direction": "in"
    }
  }'
```

## Available 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 and S455 warnings
- get_invoices — Outstanding invoices and summary stats
- create_transaction — Record income or expense
- update_transaction — Modify existing transaction
- categorize_transaction — Get AI category suggestion
- list_categories — Available categories by type
- create_deadline — Create filing/tax deadline reminders
- search_documents — Find stored documents
- upload_document — Store receipts/invoices

## Available Resources
- accountsos://company — Company information
- accountsos://transactions — Recent transactions
- accountsos://documents — Stored receipts and invoices
- accountsos://deadlines — Upcoming filing deadlines

## Scopes
- read — Query data (transactions, balances, deadlines, documents)
- write — Create/update data (includes read)
- admin — Manage company settings (includes write)

## Authentication
All requests require:
- Header: Authorization: Bearer YOUR_API_KEY

Request API access through the dashboard or hello@accounts-os.com

## UK-Specific Features
- VAT schemes: Standard, Flat Rate, Cash Accounting
- Tax year alignment: April to April
- HMRC-compliant categories
- Deadline tracking: CT600, VAT returns, Confirmation Statements

## Human Contact
- Support: hello@accounts-os.com
- Website: https://accounts-os.com
- Built by: Thrive Venture Labs (https://thriveventurelabs.com)