@alfe.ai/xero-mcp 0.3.16 → 0.3.18
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/README.md +32 -7
- package/dist/server.cjs +856 -0
- package/dist/server.d.cts +108 -0
- package/dist/server.d.ts +108 -1
- package/dist/server.js +811 -330
- package/package.json +11 -8
package/README.md
CHANGED
|
@@ -1,16 +1,41 @@
|
|
|
1
|
-
#
|
|
1
|
+
# `@alfe.ai/xero-mcp`
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Runtime-agnostic stdio MCP proxy that combines Alfe-managed Xero OAuth
|
|
4
|
+
credentials with the official `@xeroapi/xero-mcp-server` tool catalog.
|
|
4
5
|
|
|
5
|
-
Part of [
|
|
6
|
+
Part of [Alfe](https://alfe.ai), the operating system for AI agents.
|
|
6
7
|
|
|
7
|
-
##
|
|
8
|
+
## Runtime contract
|
|
9
|
+
|
|
10
|
+
- `xero_list_accounts` reports every visible Xero connection and whether its
|
|
11
|
+
local credential child is ready.
|
|
12
|
+
- Every other tool requires an explicit Xero organisation UUID in
|
|
13
|
+
`xeroTenantId`; the proxy strips it before forwarding to the child.
|
|
14
|
+
- The official child chooses the first organisation available to its token.
|
|
15
|
+
To prevent accidental cross-organisation actions, this proxy enables a
|
|
16
|
+
connection only when the token exposes exactly one organisation and that ID
|
|
17
|
+
matches the selector metadata.
|
|
18
|
+
- Token refresh targets the exact Connect `accountIdentifier`, verifies the
|
|
19
|
+
refreshed token, and atomically swaps only that organisation's child.
|
|
20
|
+
- Child binaries are resolved from the exact installed dependency. Tool
|
|
21
|
+
catalogs, arguments, results, process lifetimes, and diagnostics are bounded.
|
|
22
|
+
|
|
23
|
+
An OAuth grant spanning multiple Xero organisations currently appears as
|
|
24
|
+
unavailable. Reconnect with a grant that exposes one organisation; dedicated
|
|
25
|
+
multi-organisation selection is a future product flow.
|
|
26
|
+
|
|
27
|
+
## Run
|
|
28
|
+
|
|
29
|
+
The Alfe integration launches the executable over stdio:
|
|
8
30
|
|
|
9
31
|
```bash
|
|
10
|
-
|
|
32
|
+
npx -y @alfe.ai/xero-mcp@0.3.16
|
|
11
33
|
```
|
|
12
34
|
|
|
35
|
+
The proxy reads the agent's existing Alfe runtime configuration. It does not
|
|
36
|
+
accept Xero credentials through command-line arguments.
|
|
37
|
+
|
|
13
38
|
## Links
|
|
14
39
|
|
|
15
|
-
-
|
|
16
|
-
-
|
|
40
|
+
- [Alfe](https://alfe.ai)
|
|
41
|
+
- [Documentation](https://docs.alfe.ai)
|