{
  "schemaVersion": "1.0",
  "item": {
    "slug": "accountsos",
    "name": "Accountsos",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/paulgosnell/accountsos",
    "canonicalUrl": "https://clawhub.ai/paulgosnell/accountsos",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/accountsos",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=accountsos",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/accountsos"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/accountsos",
    "agentPageUrl": "https://openagent3.xyz/skills/accountsos/agent",
    "manifestUrl": "https://openagent3.xyz/skills/accountsos/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/accountsos/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "AccountsOS",
        "body": "AI-native accounting. Your agent runs the books so your human doesn't have to.\n\nBase URL: https://accounts-os.com/api/mcp"
      },
      {
        "title": "What is AccountsOS?",
        "body": "AccountsOS is accounting infrastructure for AI agents. Built for UK micro-businesses (Ltd companies, sole traders):\n\nTransaction tracking — Income, expenses, categorized automatically\nVAT management — Calculate returns, track what's owed\nDeadline alerts — Corporation tax, VAT, confirmation statements\nDocument storage — Receipts, invoices, contracts\nAI categorization — Smart category suggestions for every transaction\n\nNo spreadsheets. No manual entry. Just tell your agent what happened."
      },
      {
        "title": "1. Get API Key",
        "body": "Option A: Self-Signup (recommended) — Create an account yourself with one request:\n\ncurl -X POST https://accounts-os.com/api/agent-signup \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"email\": \"founder@example.com\",\n    \"company_name\": \"Acme Ltd\",\n    \"full_name\": \"Jane Smith\"\n  }'\n\nResponse includes api_key for immediate use. Your human gets a welcome email to claim the account.\n\nOption B: Manual — Your human signs up at https://accounts-os.com and generates an API key from the dashboard.\n\nexport ACCOUNTSOS_API_KEY=\"sk_live_...\""
      },
      {
        "title": "2. Check the Books",
        "body": "# Get recent transactions\ncurl -X POST https://accounts-os.com/api/mcp \\\n  -H \"Authorization: Bearer $ACCOUNTSOS_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"type\": \"tool\", \"name\": \"get_transactions\", \"arguments\": {\"limit\": 10}}'"
      },
      {
        "title": "3. Record a Transaction",
        "body": "curl -X POST https://accounts-os.com/api/mcp \\\n  -H \"Authorization: Bearer $ACCOUNTSOS_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"type\": \"tool\",\n    \"name\": \"create_transaction\",\n    \"arguments\": {\n      \"date\": \"2026-02-01\",\n      \"description\": \"Client payment - Website project\",\n      \"amount\": 2500.00,\n      \"direction\": \"in\"\n    }\n  }'"
      },
      {
        "title": "4. Check VAT Position",
        "body": "curl -X POST https://accounts-os.com/api/mcp \\\n  -H \"Authorization: Bearer $ACCOUNTSOS_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"type\": \"tool\", \"name\": \"get_vat_summary\", \"arguments\": {}}'"
      },
      {
        "title": "API Reference",
        "body": "AccountsOS uses an MCP-style API. All requests go to /api/mcp with a JSON body specifying the tool or resource."
      },
      {
        "title": "Authentication",
        "body": "Authorization: Bearer your_api_key\nContent-Type: application/json"
      },
      {
        "title": "Tools (Actions)",
        "body": "Get transactions:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_transactions\",\n  \"arguments\": {\n    \"from_date\": \"2026-01-01\",\n    \"to_date\": \"2026-01-31\",\n    \"direction\": \"in\",\n    \"limit\": 50\n  }\n}\n\nGet balance:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_balance\",\n  \"arguments\": {\"account_id\": \"optional\"}\n}\n\nGet VAT summary:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_vat_summary\",\n  \"arguments\": {\"quarter\": \"Q4 2025\"}\n}\n\nGet deadlines:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_deadlines\",\n  \"arguments\": {\"include_completed\": false}\n}\n\nCreate transaction:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"create_transaction\",\n  \"arguments\": {\n    \"date\": \"2026-02-01\",\n    \"description\": \"AWS hosting - January\",\n    \"amount\": 127.50,\n    \"direction\": \"out\",\n    \"category_id\": \"optional\",\n    \"vat_rate\": 20,\n    \"notes\": \"Monthly infrastructure\"\n  }\n}\n\nDirections: in (income) or out (expense)\n\nUpdate transaction:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"update_transaction\",\n  \"arguments\": {\n    \"transaction_id\": \"uuid\",\n    \"category_id\": \"new_category\",\n    \"notes\": \"Updated notes\"\n  }\n}\n\nAI categorization:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"categorize_transaction\",\n  \"arguments\": {\"transaction_id\": \"uuid\"}\n}\n\nReturns suggested category based on description and historical patterns.\n\nList categories:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"list_categories\",\n  \"arguments\": {\"type\": \"expense\"}\n}\n\nTypes: income, expense, asset, liability, equity\n\nCreate deadline:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"create_deadline\",\n  \"arguments\": {\n    \"type\": \"VAT Return\",\n    \"due_date\": \"2026-02-07\",\n    \"notes\": \"Q4 2025 VAT\"\n  }\n}\n\nSearch documents:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"search_documents\",\n  \"arguments\": {\n    \"query\": \"invoice\",\n    \"type\": \"receipt\"\n  }\n}\n\nUpload document:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"upload_document\",\n  \"arguments\": {\n    \"file_name\": \"receipt.pdf\",\n    \"file_data\": \"base64_encoded_data\",\n    \"document_type\": \"receipt\"\n  }\n}\n\nGet Director's Loan Account balance:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_dla_balance\",\n  \"arguments\": {\n    \"limit\": 10\n  }\n}\n\nReturns DLA balance with S455 tax warnings if the account is overdrawn.\n\nGet invoices:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_invoices\",\n  \"arguments\": {\n    \"status\": \"all\",\n    \"contact_id\": \"optional\"\n  }\n}\n\nStatus options: draft, sent, paid, overdue, cancelled, all\nReturns invoices with summary of outstanding and overdue amounts.\n\nCreate deadline:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"create_deadline\",\n  \"arguments\": {\n    \"type\": \"VAT Return\",\n    \"due_date\": \"2026-02-07\",\n    \"notes\": \"Q4 2025 VAT\"\n  }\n}"
      },
      {
        "title": "Agent Self-Signup",
        "body": "POST /api/agent-signup — No authentication required.\n\nCreate an account and get an API key in one request:\n\n{\n  \"email\": \"founder@example.com\",\n  \"company_name\": \"Acme Ltd\",\n  \"full_name\": \"Jane Smith\",\n  \"entity_type\": \"ltd\"\n}\n\nRequired: email, company_name\nOptional: full_name, entity_type (default: ltd)\n\nEntity types: ltd, plc, llp, sole_trader, partnership, cic, charity, overseas, other\n\nResponse:\n\n{\n  \"api_key\": \"sk_live_...\",\n  \"company_id\": \"uuid\",\n  \"user_id\": \"uuid\",\n  \"trial_ends_at\": \"2026-02-22T...\",\n  \"api_base\": \"https://accounts-os.com/api/mcp\",\n  \"message\": \"Account created. Store this API key — it will not be shown again.\"\n}\n\nThe API key has read + write scopes. 14-day free trial. Human receives a welcome email.\n\nReturns 409 if the email is already registered."
      },
      {
        "title": "Scopes",
        "body": "API keys support three permission levels:\n\nread — Query transactions, balances, deadlines, documents, invoices, DLA\nwrite — Create/update transactions, documents, deadlines (includes read)\nadmin — Manage company settings (includes write)\n\nYour API key's scope is configured in the dashboard. Requests beyond your scope return a 403 error."
      },
      {
        "title": "Resources (Read-only)",
        "body": "Company info:\n\n{\n  \"type\": \"resource\",\n  \"uri\": \"accountsos://company\"\n}\n\nRecent transactions:\n\n{\n  \"type\": \"resource\",\n  \"uri\": \"accountsos://transactions\"\n}"
      },
      {
        "title": "Daily Bookkeeping",
        "body": "Your human mentions expenses throughout the day? Log them:\n\n# Human: \"Just paid £45 for the Figma subscription\"\naccountsos.create_transaction(\n    date=today,\n    description=\"Figma subscription - monthly\",\n    amount=45.00,\n    direction=\"out\"\n)\n# AI auto-categorizes as \"Software & Subscriptions\""
      },
      {
        "title": "Invoice Follow-up",
        "body": "Track what's owed:\n\n# Check unpaid invoices\ntransactions = accountsos.get_transactions(\n    direction=\"in\",\n    status=\"pending\"\n)\nfor t in transactions:\n    if t.days_overdue > 14:\n        # Alert human or draft follow-up email\n        notify(f\"Invoice {t.description} is {t.days_overdue} days overdue\")"
      },
      {
        "title": "VAT Prep",
        "body": "Quarterly VAT? Already calculated:\n\nvat = accountsos.get_vat_summary(quarter=\"Q4 2025\")\nprint(f\"VAT owed: £{vat.amount_owed}\")\nprint(f\"Due: {vat.due_date}\")\n# Surface to human before deadline"
      },
      {
        "title": "Deadline Monitoring",
        "body": "Never miss a filing:\n\ndeadlines = accountsos.get_deadlines()\nfor d in deadlines:\n    if d.days_until < 7:\n        alert(f\"⚠️ {d.type} due in {d.days_until} days\")"
      },
      {
        "title": "Expense Categorization",
        "body": "New transaction? Categorize it:\n\n# Get AI suggestion\nsuggestion = accountsos.categorize_transaction(transaction_id)\nif suggestion.confidence > 0.8:\n    accountsos.update_transaction(transaction_id, {\n        \"category_id\": suggestion.category_id\n    })"
      },
      {
        "title": "Add to Your Heartbeat",
        "body": "## AccountsOS (daily or weekly)\n\n### Daily\n- Check for new transactions needing categorization\n- Log any expenses human mentioned today\n\n### Weekly\n- Review uncategorized transactions\n- Check upcoming deadlines (next 14 days)\n- Summarize week's P&L if human asks\n\n### Quarterly\n- Generate VAT summary\n- Surface filing deadlines\n- Remind human to review before submission"
      },
      {
        "title": "UK-Specific Features",
        "body": "FeatureDetailsVAT schemesStandard, Flat Rate, Cash AccountingTax yearsApril-April alignmentDeadlinesCT600, VAT, Confirmation StatementCategoriesHMRC-aligned expense categories\n\nBuilt for UK Ltd companies and sole traders. Knows the rules so you don't have to."
      },
      {
        "title": "Example: Weekly Finance Check",
        "body": "import os\nimport requests\nfrom datetime import datetime, timedelta\n\nAPI_URL = \"https://accounts-os.com/api/mcp\"\nheaders = {\n    \"Authorization\": f\"Bearer {os.environ['ACCOUNTSOS_API_KEY']}\",\n    \"Content-Type\": \"application/json\"\n}\n\ndef call_tool(name, args={}):\n    resp = requests.post(API_URL, headers=headers, json={\n        \"type\": \"tool\", \"name\": name, \"arguments\": args\n    })\n    return resp.json()[\"result\"]\n\n# 1. Check balance\nbalance = call_tool(\"get_balance\")\nprint(f\"💰 Current balance: £{balance['amount']}\")\n\n# 2. This week's transactions\nweek_ago = (datetime.now() - timedelta(days=7)).strftime(\"%Y-%m-%d\")\ntransactions = call_tool(\"get_transactions\", {\"from_date\": week_ago})\nincome = sum(t[\"amount\"] for t in transactions if t[\"direction\"] == \"in\")\nexpenses = sum(t[\"amount\"] for t in transactions if t[\"direction\"] == \"out\")\nprint(f\"📈 Week: +£{income} / -£{expenses}\")\n\n# 3. Upcoming deadlines\ndeadlines = call_tool(\"get_deadlines\")\nurgent = [d for d in deadlines if d[\"days_until\"] < 14]\nif urgent:\n    print(f\"⚠️ {len(urgent)} deadlines in next 2 weeks\")\n    for d in urgent:\n        print(f\"  - {d['type']}: {d['due_date']}\")\n\n# 4. VAT position\nvat = call_tool(\"get_vat_summary\")\nprint(f\"🧾 VAT owed: £{vat['amount_owed']}\")"
      },
      {
        "title": "Links",
        "body": "App: https://accounts-os.com\nSupport: hello@accounts-os.com"
      },
      {
        "title": "Your Human's Financial Copilot",
        "body": "Most people hate bookkeeping. They forget receipts, miss deadlines, panic at tax time.\n\nYou don't forget. You don't panic. You just log, categorize, and surface what matters.\n\nBe the agent that makes finances boring (in a good way).\n\nBuilt by Thrive Venture Labs"
      }
    ],
    "body": "AccountsOS\n\nAI-native accounting. Your agent runs the books so your human doesn't have to.\n\nBase URL: https://accounts-os.com/api/mcp\n\nWhat is AccountsOS?\n\nAccountsOS is accounting infrastructure for AI agents. Built for UK micro-businesses (Ltd companies, sole traders):\n\nTransaction tracking — Income, expenses, categorized automatically\nVAT management — Calculate returns, track what's owed\nDeadline alerts — Corporation tax, VAT, confirmation statements\nDocument storage — Receipts, invoices, contracts\nAI categorization — Smart category suggestions for every transaction\n\nNo spreadsheets. No manual entry. Just tell your agent what happened.\n\nQuick Start (For AI Agents)\n1. Get API Key\n\nOption A: Self-Signup (recommended) — Create an account yourself with one request:\n\ncurl -X POST https://accounts-os.com/api/agent-signup \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"email\": \"founder@example.com\",\n    \"company_name\": \"Acme Ltd\",\n    \"full_name\": \"Jane Smith\"\n  }'\n\n\nResponse includes api_key for immediate use. Your human gets a welcome email to claim the account.\n\nOption B: Manual — Your human signs up at https://accounts-os.com and generates an API key from the dashboard.\n\nexport ACCOUNTSOS_API_KEY=\"sk_live_...\"\n\n2. Check the Books\n# Get recent transactions\ncurl -X POST https://accounts-os.com/api/mcp \\\n  -H \"Authorization: Bearer $ACCOUNTSOS_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"type\": \"tool\", \"name\": \"get_transactions\", \"arguments\": {\"limit\": 10}}'\n\n3. Record a Transaction\ncurl -X POST https://accounts-os.com/api/mcp \\\n  -H \"Authorization: Bearer $ACCOUNTSOS_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"type\": \"tool\",\n    \"name\": \"create_transaction\",\n    \"arguments\": {\n      \"date\": \"2026-02-01\",\n      \"description\": \"Client payment - Website project\",\n      \"amount\": 2500.00,\n      \"direction\": \"in\"\n    }\n  }'\n\n4. Check VAT Position\ncurl -X POST https://accounts-os.com/api/mcp \\\n  -H \"Authorization: Bearer $ACCOUNTSOS_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"type\": \"tool\", \"name\": \"get_vat_summary\", \"arguments\": {}}'\n\nAPI Reference\n\nAccountsOS uses an MCP-style API. All requests go to /api/mcp with a JSON body specifying the tool or resource.\n\nAuthentication\nAuthorization: Bearer your_api_key\nContent-Type: application/json\n\nTools (Actions)\n\nGet transactions:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_transactions\",\n  \"arguments\": {\n    \"from_date\": \"2026-01-01\",\n    \"to_date\": \"2026-01-31\",\n    \"direction\": \"in\",\n    \"limit\": 50\n  }\n}\n\n\nGet balance:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_balance\",\n  \"arguments\": {\"account_id\": \"optional\"}\n}\n\n\nGet VAT summary:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_vat_summary\",\n  \"arguments\": {\"quarter\": \"Q4 2025\"}\n}\n\n\nGet deadlines:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_deadlines\",\n  \"arguments\": {\"include_completed\": false}\n}\n\n\nCreate transaction:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"create_transaction\",\n  \"arguments\": {\n    \"date\": \"2026-02-01\",\n    \"description\": \"AWS hosting - January\",\n    \"amount\": 127.50,\n    \"direction\": \"out\",\n    \"category_id\": \"optional\",\n    \"vat_rate\": 20,\n    \"notes\": \"Monthly infrastructure\"\n  }\n}\n\n\nDirections: in (income) or out (expense)\n\nUpdate transaction:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"update_transaction\",\n  \"arguments\": {\n    \"transaction_id\": \"uuid\",\n    \"category_id\": \"new_category\",\n    \"notes\": \"Updated notes\"\n  }\n}\n\n\nAI categorization:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"categorize_transaction\",\n  \"arguments\": {\"transaction_id\": \"uuid\"}\n}\n\n\nReturns suggested category based on description and historical patterns.\n\nList categories:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"list_categories\",\n  \"arguments\": {\"type\": \"expense\"}\n}\n\n\nTypes: income, expense, asset, liability, equity\n\nCreate deadline:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"create_deadline\",\n  \"arguments\": {\n    \"type\": \"VAT Return\",\n    \"due_date\": \"2026-02-07\",\n    \"notes\": \"Q4 2025 VAT\"\n  }\n}\n\n\nSearch documents:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"search_documents\",\n  \"arguments\": {\n    \"query\": \"invoice\",\n    \"type\": \"receipt\"\n  }\n}\n\n\nUpload document:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"upload_document\",\n  \"arguments\": {\n    \"file_name\": \"receipt.pdf\",\n    \"file_data\": \"base64_encoded_data\",\n    \"document_type\": \"receipt\"\n  }\n}\n\n\nGet Director's Loan Account balance:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_dla_balance\",\n  \"arguments\": {\n    \"limit\": 10\n  }\n}\n\n\nReturns DLA balance with S455 tax warnings if the account is overdrawn.\n\nGet invoices:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"get_invoices\",\n  \"arguments\": {\n    \"status\": \"all\",\n    \"contact_id\": \"optional\"\n  }\n}\n\n\nStatus options: draft, sent, paid, overdue, cancelled, all Returns invoices with summary of outstanding and overdue amounts.\n\nCreate deadline:\n\n{\n  \"type\": \"tool\",\n  \"name\": \"create_deadline\",\n  \"arguments\": {\n    \"type\": \"VAT Return\",\n    \"due_date\": \"2026-02-07\",\n    \"notes\": \"Q4 2025 VAT\"\n  }\n}\n\nAgent Self-Signup\n\nPOST /api/agent-signup — No authentication required.\n\nCreate an account and get an API key in one request:\n\n{\n  \"email\": \"founder@example.com\",\n  \"company_name\": \"Acme Ltd\",\n  \"full_name\": \"Jane Smith\",\n  \"entity_type\": \"ltd\"\n}\n\n\nRequired: email, company_name Optional: full_name, entity_type (default: ltd)\n\nEntity types: ltd, plc, llp, sole_trader, partnership, cic, charity, overseas, other\n\nResponse:\n\n{\n  \"api_key\": \"sk_live_...\",\n  \"company_id\": \"uuid\",\n  \"user_id\": \"uuid\",\n  \"trial_ends_at\": \"2026-02-22T...\",\n  \"api_base\": \"https://accounts-os.com/api/mcp\",\n  \"message\": \"Account created. Store this API key — it will not be shown again.\"\n}\n\n\nThe API key has read + write scopes. 14-day free trial. Human receives a welcome email.\n\nReturns 409 if the email is already registered.\n\nScopes\n\nAPI keys support three permission levels:\n\nread — Query transactions, balances, deadlines, documents, invoices, DLA\nwrite — Create/update transactions, documents, deadlines (includes read)\nadmin — Manage company settings (includes write)\n\nYour API key's scope is configured in the dashboard. Requests beyond your scope return a 403 error.\n\nResources (Read-only)\n\nCompany info:\n\n{\n  \"type\": \"resource\",\n  \"uri\": \"accountsos://company\"\n}\n\n\nRecent transactions:\n\n{\n  \"type\": \"resource\",\n  \"uri\": \"accountsos://transactions\"\n}\n\nUse Cases for Agents\nDaily Bookkeeping\n\nYour human mentions expenses throughout the day? Log them:\n\n# Human: \"Just paid £45 for the Figma subscription\"\naccountsos.create_transaction(\n    date=today,\n    description=\"Figma subscription - monthly\",\n    amount=45.00,\n    direction=\"out\"\n)\n# AI auto-categorizes as \"Software & Subscriptions\"\n\nInvoice Follow-up\n\nTrack what's owed:\n\n# Check unpaid invoices\ntransactions = accountsos.get_transactions(\n    direction=\"in\",\n    status=\"pending\"\n)\nfor t in transactions:\n    if t.days_overdue > 14:\n        # Alert human or draft follow-up email\n        notify(f\"Invoice {t.description} is {t.days_overdue} days overdue\")\n\nVAT Prep\n\nQuarterly VAT? Already calculated:\n\nvat = accountsos.get_vat_summary(quarter=\"Q4 2025\")\nprint(f\"VAT owed: £{vat.amount_owed}\")\nprint(f\"Due: {vat.due_date}\")\n# Surface to human before deadline\n\nDeadline Monitoring\n\nNever miss a filing:\n\ndeadlines = accountsos.get_deadlines()\nfor d in deadlines:\n    if d.days_until < 7:\n        alert(f\"⚠️ {d.type} due in {d.days_until} days\")\n\nExpense Categorization\n\nNew transaction? Categorize it:\n\n# Get AI suggestion\nsuggestion = accountsos.categorize_transaction(transaction_id)\nif suggestion.confidence > 0.8:\n    accountsos.update_transaction(transaction_id, {\n        \"category_id\": suggestion.category_id\n    })\n\nAdd to Your Heartbeat\n## AccountsOS (daily or weekly)\n\n### Daily\n- Check for new transactions needing categorization\n- Log any expenses human mentioned today\n\n### Weekly\n- Review uncategorized transactions\n- Check upcoming deadlines (next 14 days)\n- Summarize week's P&L if human asks\n\n### Quarterly\n- Generate VAT summary\n- Surface filing deadlines\n- Remind human to review before submission\n\nUK-Specific Features\nFeature\tDetails\nVAT schemes\tStandard, Flat Rate, Cash Accounting\nTax years\tApril-April alignment\nDeadlines\tCT600, VAT, Confirmation Statement\nCategories\tHMRC-aligned expense categories\n\nBuilt for UK Ltd companies and sole traders. Knows the rules so you don't have to.\n\nExample: Weekly Finance Check\nimport os\nimport requests\nfrom datetime import datetime, timedelta\n\nAPI_URL = \"https://accounts-os.com/api/mcp\"\nheaders = {\n    \"Authorization\": f\"Bearer {os.environ['ACCOUNTSOS_API_KEY']}\",\n    \"Content-Type\": \"application/json\"\n}\n\ndef call_tool(name, args={}):\n    resp = requests.post(API_URL, headers=headers, json={\n        \"type\": \"tool\", \"name\": name, \"arguments\": args\n    })\n    return resp.json()[\"result\"]\n\n# 1. Check balance\nbalance = call_tool(\"get_balance\")\nprint(f\"💰 Current balance: £{balance['amount']}\")\n\n# 2. This week's transactions\nweek_ago = (datetime.now() - timedelta(days=7)).strftime(\"%Y-%m-%d\")\ntransactions = call_tool(\"get_transactions\", {\"from_date\": week_ago})\nincome = sum(t[\"amount\"] for t in transactions if t[\"direction\"] == \"in\")\nexpenses = sum(t[\"amount\"] for t in transactions if t[\"direction\"] == \"out\")\nprint(f\"📈 Week: +£{income} / -£{expenses}\")\n\n# 3. Upcoming deadlines\ndeadlines = call_tool(\"get_deadlines\")\nurgent = [d for d in deadlines if d[\"days_until\"] < 14]\nif urgent:\n    print(f\"⚠️ {len(urgent)} deadlines in next 2 weeks\")\n    for d in urgent:\n        print(f\"  - {d['type']}: {d['due_date']}\")\n\n# 4. VAT position\nvat = call_tool(\"get_vat_summary\")\nprint(f\"🧾 VAT owed: £{vat['amount_owed']}\")\n\nLinks\nApp: https://accounts-os.com\nSupport: hello@accounts-os.com\nYour Human's Financial Copilot\n\nMost people hate bookkeeping. They forget receipts, miss deadlines, panic at tax time.\n\nYou don't forget. You don't panic. You just log, categorize, and surface what matters.\n\nBe the agent that makes finances boring (in a good way).\n\nBuilt by Thrive Venture Labs"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/paulgosnell/accountsos",
    "publisherUrl": "https://clawhub.ai/paulgosnell/accountsos",
    "owner": "paulgosnell",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/accountsos",
    "downloadUrl": "https://openagent3.xyz/downloads/accountsos",
    "agentUrl": "https://openagent3.xyz/skills/accountsos/agent",
    "manifestUrl": "https://openagent3.xyz/skills/accountsos/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/accountsos/agent.md"
  }
}