@desktopaccountingapi/quickbooks-desktop-mcp 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## 0.1.0
4
4
 
5
- First release of `@desktopaccountingapi/quickbooks-desktop-mcp`, generated from API contract sha256 `79b06eb20083` (API version 1.0.0, 275 operations).
5
+ First release of `@desktopaccountingapi/quickbooks-desktop-mcp`, generated from API contract sha256 `68a0d76d6b51` (API version 1.0.0, 275 operations).
6
6
 
7
7
  - Local MCP server over stdio: `npx -y @desktopaccountingapi/quickbooks-desktop-mcp`. Node.js 20 or later on Windows, macOS and Linux; no other runtime and no runtime dependencies.
8
8
  - Tools: `list_end_users`, `list_api_endpoints`, `get_api_endpoint_schema`, `invoke_api_endpoint`, `search_docs`; optional one tool per operation with `--resources`.
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
  - Writes carry an idempotency key and are never retried blindly. Read-only keys are enforced by the API itself.
7
7
  - Runs over stdio with Node.js 20 or later on Windows, macOS and Linux, with no runtime dependencies.
8
8
 
9
- The current version is **0.3.0**. [MCP guide](https://www.desktopaccountingapi.com/docs/guides/mcp/) · [Documentation](https://www.desktopaccountingapi.com/docs/) · [Changelog](CHANGELOG.md) · [Status](https://status.desktopaccountingapi.com)
9
+ The current version is **0.4.0**. [MCP guide](https://www.desktopaccountingapi.com/docs/guides/mcp/) · [Documentation](https://www.desktopaccountingapi.com/docs/) · [Changelog](CHANGELOG.md) · [Status](https://status.desktopaccountingapi.com)
10
10
 
11
11
  ## Hosted server or local package
12
12
 
@@ -37,14 +37,14 @@ Open **Settings > Developer > Edit Config** (`claude_desktop_config.json`) and a
37
37
  "mcpServers": {
38
38
  "quickbooks-desktop": {
39
39
  "command": "npx",
40
- "args": ["-y", "@desktopaccountingapi/quickbooks-desktop-mcp@0.3.0"],
40
+ "args": ["-y", "@desktopaccountingapi/quickbooks-desktop-mcp@0.4.0"],
41
41
  "env": { "DAAPI_SECRET_KEY": "sk_live_..." }
42
42
  }
43
43
  }
44
44
  }
45
45
  ```
46
46
 
47
- If the file already has an `mcpServers` section, add the `quickbooks-desktop` entry inside it, then restart Claude Desktop. Drop `@0.3.0` from the package name to always run the latest version.
47
+ If the file already has an `mcpServers` section, add the `quickbooks-desktop` entry inside it, then restart Claude Desktop. Drop `@0.4.0` from the package name to always run the latest version.
48
48
 
49
49
  ### Claude Code
50
50
 
@@ -173,7 +173,7 @@ Clients send their own secret key as `Authorization: Bearer sk_...`; the server
173
173
  ## Versioning and changelog
174
174
 
175
175
  - The package follows [semantic versioning](https://semver.org/) and is released together with the [Node.js](https://github.com/DesktopAccountingAPI/quickbooks-desktop-node), [Python](https://github.com/DesktopAccountingAPI/quickbooks-desktop-python), [.NET](https://github.com/DesktopAccountingAPI/quickbooks-desktop-dotnet) and [Java](https://github.com/DesktopAccountingAPI/quickbooks-desktop-java) SDKs, with the same version number.
176
- - It is generated from the Desktop Accounting API contract (sha256 `79b06eb20083...` for this release) by the same pipeline as the SDKs.
176
+ - It is generated from the Desktop Accounting API contract (sha256 `68a0d76d6b51...` for this release) by the same pipeline as the SDKs.
177
177
  - Every release is listed in [CHANGELOG.md](CHANGELOG.md) and tagged `v<version>` on GitHub.
178
178
 
179
179
  ## Support
package/dist/catalog.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // Code generated by packages/sdk-generator from packages/mcp/src. DO NOT EDIT.
2
- // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:79b06eb2008381661d24d3bd5e23643483ec1bf9b70d5f4cdff2a2a71e22fe94
2
+ // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:68a0d76d6b51187adfc66d768eae8e30675b5093f4ae538b0d9c32c905b9bb2d
3
3
  // MCP endpoint catalog: a compact, input-only view of the public OpenAPI contract that the MCP
4
4
  // tools search, describe and invoke. Built from packages/api-contract/generated/openapi.json by
5
5
  // scripts/api-contract.mjs (committed as packages/mcp/generated/catalog.json, drift-checked) and
package/dist/catalog.json CHANGED
@@ -210,7 +210,7 @@
210
210
  "tag": "Passthrough",
211
211
  "group": "Platform",
212
212
  "summary": "Send a raw qbXML request",
213
- "description": "Sends qbXML request elements directly to the end user's QuickBooks Desktop and returns QuickBooks' response. Send JSON (`application/json`) or a `<QBXMLMsgsRq>` fragment (`application/xml`); the response uses the same format. We add the qbXML envelope, `onError=\"stopOnError\"` unless you set it, and a `newMessageSetID` for writes. A body that contains any element other than a query (`...QueryRq`) is a write: send an `Idempotency-Key` to make retries safe. A read-only secret key can send only queries; a write returns `403 API_KEY_READ_ONLY`. The response is `200` with each message's own status; the call fails only when QuickBooks processed no message successfully. Each call creates a request resource (`Daapi-Request-Id`).",
213
+ "description": "Sends qbXML request elements directly to the end user's QuickBooks Desktop and returns QuickBooks' response. Send JSON (`application/json`) or a `<QBXMLMsgsRq>` fragment (`application/xml`); the response uses the same format. We add the qbXML envelope, `onError=\"stopOnError\"` unless you set it, and a `newMessageSetID` for writes. A body that contains any element other than a query (`...QueryRq`) is a write: send an `Idempotency-Key` to make retries safe. A read-only secret key can send only queries; a write returns `403 API_KEY_READ_ONLY`. The response is `200` with each message's own status; the call fails only when QuickBooks processed no message successfully. The error then describes the first message's status (`code`, `integrationCode`), and `error.details.requests` lists every message of the set in order: `request` (element name, such as `CustomerAddRq`), `requestID` (the `requestID` attribute you sent, or null), `statusCode`, `statusSeverity` and `statusMessage`. Messages QuickBooks skipped after a `stopOnError` failure show status 3231 (not processed). Each call creates a request resource (`Daapi-Request-Id`).",
214
214
  "write": true,
215
215
  "endUser": false,
216
216
  "idempotent": true,
package/dist/cli.js CHANGED
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  // Code generated by packages/sdk-generator from packages/mcp/src. DO NOT EDIT.
3
- // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:79b06eb2008381661d24d3bd5e23643483ec1bf9b70d5f4cdff2a2a71e22fe94
3
+ // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:68a0d76d6b51187adfc66d768eae8e30675b5093f4ae538b0d9c32c905b9bb2d
4
4
  // Local (stdio) MCP server for the Desktop Accounting API.
5
5
  //
6
6
  // npx -y @desktopaccountingapi/quickbooks-desktop-mcp [--read-only] [--resources invoices,customers] [--end-user-id eu_...]
package/dist/http.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // Code generated by packages/sdk-generator from packages/mcp/src. DO NOT EDIT.
2
- // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:79b06eb2008381661d24d3bd5e23643483ec1bf9b70d5f4cdff2a2a71e22fe94
2
+ // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:68a0d76d6b51187adfc66d768eae8e30675b5093f4ae538b0d9c32c905b9bb2d
3
3
  // Streamable HTTP transport (MCP 2025-03-26 and later), stateless: each POST carries one JSON-RPC
4
4
  // message (or a batch, for 2025-03-26 clients) and is answered with application/json. No server
5
5
  // sessions and no server-initiated stream, so GET and DELETE return 405. Web-standard Request and
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // Code generated by packages/sdk-generator from packages/mcp/src. DO NOT EDIT.
2
- // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:79b06eb2008381661d24d3bd5e23643483ec1bf9b70d5f4cdff2a2a71e22fe94
2
+ // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:68a0d76d6b51187adfc66d768eae8e30675b5093f4ae538b0d9c32c905b9bb2d
3
3
  // Runtime-agnostic MCP server core (no Node-only imports); the tool design is in tools.ts.
4
4
  export { buildCatalog, defsFor } from './catalog.js';
5
5
  export { handleMcpRequest } from './http.js';
package/dist/key.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // Code generated by packages/sdk-generator from packages/mcp/src. DO NOT EDIT.
2
- // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:79b06eb2008381661d24d3bd5e23643483ec1bf9b70d5f4cdff2a2a71e22fe94
2
+ // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:68a0d76d6b51187adfc66d768eae8e30675b5093f4ae538b0d9c32c905b9bb2d
3
3
  // Local secret-key check (same rule as the API and SDKs, docs/api-conventions.md section 2):
4
4
  // `sk_live_`/`sk_test_` + 40 base62 chars, the last 6 being the base62 CRC32 of the first 34.
5
5
  // Rejecting a mistyped key locally keeps it from counting against the API's per-IP
package/dist/server.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // Code generated by packages/sdk-generator from packages/mcp/src. DO NOT EDIT.
2
- // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:79b06eb2008381661d24d3bd5e23643483ec1bf9b70d5f4cdff2a2a71e22fe94
2
+ // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:68a0d76d6b51187adfc66d768eae8e30675b5093f4ae538b0d9c32c905b9bb2d
3
3
  // Model Context Protocol server core: JSON-RPC 2.0 message handling for the `tools` capability.
4
4
  // Transport-independent; stdio.ts and http.ts carry the messages. Implements the lifecycle
5
5
  // (initialize with version negotiation, notifications/initialized, ping) plus tools/list and
package/dist/stdio.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // Code generated by packages/sdk-generator from packages/mcp/src. DO NOT EDIT.
2
- // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:79b06eb2008381661d24d3bd5e23643483ec1bf9b70d5f4cdff2a2a71e22fe94
2
+ // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:68a0d76d6b51187adfc66d768eae8e30675b5093f4ae538b0d9c32c905b9bb2d
3
3
  // stdio transport: newline-delimited JSON-RPC on stdin/stdout (MCP specification, "stdio").
4
4
  // Only protocol messages go to stdout; diagnostics go to stderr. Pure Node.js (no Deno, no
5
5
  // POSIX-only features), so it runs the same on Windows, macOS and Linux.
package/dist/tools.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // Code generated by packages/sdk-generator from packages/mcp/src. DO NOT EDIT.
2
- // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:79b06eb2008381661d24d3bd5e23643483ec1bf9b70d5f4cdff2a2a71e22fe94
2
+ // Contract: packages/api-contract/generated/openapi.json (OpenAPI 3.1.0) sha256:68a0d76d6b51187adfc66d768eae8e30675b5093f4ae538b0d9c32c905b9bb2d
3
3
  // MCP tools over the Desktop Accounting API. Runtime-agnostic (fetch and Web Crypto only), so the
4
4
  // same code runs in the hosted Cloudflare Worker (apps/mcp) and the stdio npm package.
5
5
  //
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@desktopaccountingapi/quickbooks-desktop-mcp",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "description": "Model Context Protocol (MCP) server for Desktop Accounting API: QuickBooks Desktop for Claude, Cursor, VS Code, Codex and other AI tools.",
5
5
  "license": "MIT",
6
6
  "author": "Desktop Accounting API",