beeswax-mcp 1.2.0 → 1.3.0

package/README.md

@@ -66,12 +66,31 @@ if the agent should be able to use the matching write tools.
 
 To build quotes you need `quotes:write` plus the three lookups a quote is
 assembled from: `companies:read` (the client), `projects:read` (the project) and
-`transaction_accounts:read` (the chart of accounts each line bills to).
+`transaction_accounts:read` (the chart of accounts each line bills to — the same
+scope also covers the account's tax codes).
 
 **Keep the token secret.** It sits in plain text in your client's config file, and
 anyone who can read that file can read your account data. Revoke tokens you no
 longer use from the same settings page.
 
+## Multiple accounts
+
+A token is bound to one account, so you connect several accounts by registering **one
+server entry per account**, each with its own token and a distinct name
+(`beeswax-acme`, `beeswax-steamuk`, …). Tools are namespaced by server name, so the
+agent picks the account by picking the tool.
+
+In Claude Desktop the one-click `.mcpb` extension and manual
+`claude_desktop_config.json` entries can be enabled side by side. Two things catch
+people out. A freshly installed extension is **disabled** until you flip the toggle at
+the top of its settings — saving the token does not enable it, and while it is
+disabled it exposes no tools at all. And the config file is read only at launch, so
+adding an entry or changing a token in one needs a **full restart** of the app; a
+Cowork or cloud session already linked to your computer needs that restart *and* a
+re-link before it sees the change. The Connectors screen, the naming trade-offs and
+the Cowork details are in the setup guide:
+<https://www.beeswaxapp.com/support/mcp-setup#connecting-more-than-one-account>
+
 ## Configuration
 
 | Environment variable | Required | Default |
@@ -106,6 +125,7 @@ reports the same on demand.
 | `list_milestones`, `get_milestone` | `/milestones` |
 | `list_projects`, `get_project` | `/active_account/projects` |
 | `list_transaction_accounts` | `/active_account/transaction_accounts` |
+| `list_taxes` | `/active_account/taxes` |
 | `list_companies` | `/active_account/companies` |
 | `list_task_files`, `list_task_file_versions` | `/tasks/:id/files` (+ per-file version history) |
 | `list_project_documents`, `get_project_document`, `create_project_document` (write), `update_project_document` (write), `list_project_document_versions`, `get_project_document_version`, `restore_project_document_version` (write) | `/project_documents` (+ per-document version history) |
@@ -127,6 +147,14 @@ reports the same on demand.
   fetches. `outstanding: true` is the looser "not paid/draft, any due date" set.
 - **Dates.** `from` / `to` accept ISO (`2026-01-01`) or loose strings
   (`Jan 1 2026`); they are normalized to `YYYY-MM-DD` before being sent.
+- **Tax codes.** `list_taxes` is the lookup a product's `sell_tax_id` /
+  `buy_tax_id` needs. Read `sides` rather than `tax_type` to decide whether a
+  code can be used on a document: an account that is not registered for GST/VAT
+  still carries usable zero-rated codes, and those are stored as `tax_type`
+  `"none"` rather than income or expense. `side: "sell"` returns what a sale
+  (invoice or quote) offers, `"buy"` what an expense offers, `"payroll"` the
+  withholding codes. `default` marks the code Beeswax reaches for on its own.
+  Needs `transaction_accounts:read`.
 - **Products & services.** Beeswax stores the catalogue as *transaction
   templates*. `kind` is the **buy/sell mode**, not a product-vs-service label:
   `"sell"` offers the item on invoices and quotes, `"buy"` on expenses,

package/dist/tools.js

@@ -473,8 +473,8 @@ export const TOOLS = [
                 },
                 sell_amount: { type: "number", description: "Sell price per unit. Defaults to 0 — pass it." },
                 buy_amount: { type: "number", description: "Buy price per unit. Defaults to 0." },
-                sell_tax_id: { type: "integer", description: "Tax code applied when the item is sold." },
-                buy_tax_id: { type: "integer", description: "Tax code applied when the item is bought." },
+                sell_tax_id: { type: "integer", description: "Tax code applied when the item is sold — resolve it with list_taxes (side 'sell')." },
+                buy_tax_id: { type: "integer", description: "Tax code applied when the item is bought — resolve it with list_taxes (side 'buy')." },
                 description: { type: "string", description: "Longer description shown on documents." },
                 item_category_id: { type: "integer", description: "Category by id instead of by name. Takes precedence over item_category." },
                 active: { type: "boolean", description: "Defaults to true. false files it as archived." },
@@ -526,8 +526,8 @@ export const TOOLS = [
                 buy_transaction_account_id: { type: "integer", description: "Expense account the item is bought to." },
                 sell_amount: { type: "number" },
                 buy_amount: { type: "number" },
-                sell_tax_id: { type: "integer" },
-                buy_tax_id: { type: "integer" },
+                sell_tax_id: { type: "integer", description: "Tax code applied when the item is sold — see list_taxes." },
+                buy_tax_id: { type: "integer", description: "Tax code applied when the item is bought — see list_taxes." },
                 description: { type: "string" },
                 active: { type: "boolean", description: "false archives the item — it stays on existing documents but is no longer offered." },
                 physical_resource: { type: "boolean" },
@@ -926,6 +926,24 @@ export const TOOLS = [
             bank: args.bank,
         }),
     },
+    {
+        name: "list_taxes",
+        description: "List the account's tax codes — the ids `sell_tax_id` / `buy_tax_id` on a product, and a document line's tax, have to point at. " +
+            "Read `sides` rather than `tax_type` to decide whether a code can be used: 'sell' means invoices and quotes, 'buy' means expenses, and a zero-rated 'no tax' code often appears on both. " +
+            "An account that is not registered for GST/VAT still has usable codes here — they are the zero-percent ones. `default` marks the code Beeswax applies when nothing else is chosen. " +
+            "Requires a token with transaction_accounts:read.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                side: {
+                    type: "string",
+                    enum: ["sell", "buy", "payroll"],
+                    description: "Return only the codes offered on this side: 'sell' = invoices and quotes, 'buy' = expenses, 'payroll' = payroll withholding codes.",
+                },
+            },
+        },
+        handler: (client, args) => client.getList("/active_account/taxes", "taxes", { side: args.side }),
+    },
     {
         name: "list_companies",
         description: "List the account's clients and suppliers. Use this to resolve a client name to the company_id create_quote needs. " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beeswax-mcp",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Official MCP server for Beeswax (beeswaxapp.com) — query invoices, quotes, expenses, payments, journals, time entries, projects, products & services and tax returns from Claude and other MCP clients, and build quotes priced from your catalogue.",
   "license": "MIT",
   "homepage": "https://www.beeswaxapp.com/support/mcp-setup",