easybill-mcp 1.0.2 → 1.2.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/README.md +123 -15
- package/dist/constants.d.ts +2 -1
- package/dist/constants.js +18 -1
- package/dist/constants.js.map +1 -1
- package/dist/hosted/accounts.d.ts +13 -0
- package/dist/hosted/accounts.js +70 -0
- package/dist/hosted/accounts.js.map +1 -0
- package/dist/hosted/config.d.ts +73 -0
- package/dist/hosted/config.js +200 -0
- package/dist/hosted/config.js.map +1 -0
- package/dist/hosted/http.d.ts +23 -0
- package/dist/hosted/http.js +524 -0
- package/dist/hosted/http.js.map +1 -0
- package/dist/hosted/pages.d.ts +22 -0
- package/dist/hosted/pages.js +130 -0
- package/dist/hosted/pages.js.map +1 -0
- package/dist/hosted/provider.d.ts +54 -0
- package/dist/hosted/provider.js +190 -0
- package/dist/hosted/provider.js.map +1 -0
- package/dist/hosted/store.d.ts +119 -0
- package/dist/hosted/store.js +254 -0
- package/dist/hosted/store.js.map +1 -0
- package/dist/hosted/upstream.d.ts +68 -0
- package/dist/hosted/upstream.js +280 -0
- package/dist/hosted/upstream.js.map +1 -0
- package/dist/index.d.ts +5 -1
- package/dist/index.js +19 -24
- package/dist/index.js.map +1 -1
- package/dist/instructions.d.ts +1 -1
- package/dist/instructions.js +16 -1
- package/dist/instructions.js.map +1 -1
- package/dist/server.d.ts +26 -0
- package/dist/server.js +47 -0
- package/dist/server.js.map +1 -0
- package/dist/services/client.d.ts +43 -4
- package/dist/services/client.js +35 -9
- package/dist/services/client.js.map +1 -1
- package/dist/services/format.d.ts +17 -4
- package/dist/services/format.js.map +1 -1
- package/dist/tools/catalog.d.ts +2 -2
- package/dist/tools/catalog.js.map +1 -1
- package/dist/tools/crud.d.ts +2 -2
- package/dist/tools/crud.js.map +1 -1
- package/dist/tools/customers.d.ts +2 -2
- package/dist/tools/customers.js +12 -4
- package/dist/tools/customers.js.map +1 -1
- package/dist/tools/documents.d.ts +2 -2
- package/dist/tools/documents.js +73 -43
- package/dist/tools/documents.js.map +1 -1
- package/dist/tools/files-io.d.ts +44 -0
- package/dist/tools/files-io.js +173 -0
- package/dist/tools/files-io.js.map +1 -0
- package/dist/tools/files.d.ts +2 -2
- package/dist/tools/files.js +9 -27
- package/dist/tools/files.js.map +1 -1
- package/dist/tools/finance.d.ts +2 -2
- package/dist/tools/finance.js.map +1 -1
- package/dist/tools/incoming.d.ts +11 -0
- package/dist/tools/incoming.js +222 -0
- package/dist/tools/incoming.js.map +1 -0
- package/dist/tools/meta.d.ts +2 -2
- package/dist/tools/meta.js +14 -6
- package/dist/tools/meta.js.map +1 -1
- package/dist/tools/registry.d.ts +40 -9
- package/dist/tools/registry.js +75 -12
- package/dist/tools/registry.js.map +1 -1
- package/dist/tools/search.d.ts +9 -8
- package/dist/tools/search.js +49 -17
- package/dist/tools/search.js.map +1 -1
- package/dist/tools/work.d.ts +2 -2
- package/dist/tools/work.js.map +1 -1
- package/package.json +5 -2
package/dist/tools/search.js
CHANGED
|
@@ -1,16 +1,18 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* Customer lookup — the first question when processing an inbound inquiry:
|
|
3
|
+
* "is this company already a customer?"
|
|
3
4
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
5
|
+
* Primary path: easybill's full-text search (GET /customers/search, API 1.102),
|
|
6
|
+
* one request, covering archived contacts too. Its results come sorted by
|
|
7
|
+
* customer number, so they are re-ranked locally by how well they match.
|
|
7
8
|
*
|
|
8
|
-
*
|
|
9
|
-
* paging the customer list and scoring candidates locally.
|
|
9
|
+
* Fallback, for accounts where the search endpoint is not available: cheap exact
|
|
10
|
+
* filters, then paging the customer list and scoring candidates locally.
|
|
10
11
|
*/
|
|
11
12
|
import { z } from "zod";
|
|
12
13
|
import { SUMMARY_FIELDS } from "../constants.js";
|
|
13
14
|
import { responseFormatSchema } from "../schemas/common.js";
|
|
15
|
+
import { EasybillApiError } from "../services/client.js";
|
|
14
16
|
import { selectFields, } from "../services/format.js";
|
|
15
17
|
import { registerRead } from "./registry.js";
|
|
16
18
|
/** Legal-form and filler tokens that carry no identifying weight. */
|
|
@@ -81,22 +83,23 @@ function score(customer, queryTokens, rawQuery) {
|
|
|
81
83
|
export function registerSearchTools(server, client) {
|
|
82
84
|
registerRead(server, {
|
|
83
85
|
name: "easybill_find_customer",
|
|
84
|
-
title: "Find a customer by name, email or number
|
|
85
|
-
description: `Search for an existing customer by company name, person name, email, customer number or city.
|
|
86
|
+
title: "Find a customer or supplier by name, email or number",
|
|
87
|
+
description: `Search for an existing customer (or supplier) by company name, person name, email, customer number or city.
|
|
86
88
|
|
|
87
89
|
USE THIS FIRST whenever you need to know whether someone is already a customer — for example
|
|
88
|
-
before creating an offer or invoice from an inbound inquiry.
|
|
89
|
-
|
|
90
|
+
before creating an offer or invoice from an inbound inquiry. Uses easybill's full-text search
|
|
91
|
+
(one request, archived contacts included) and ranks the hits by how well they match. If the
|
|
92
|
+
search is unavailable it falls back to exact filters plus a local fuzzy scan of the list.
|
|
90
93
|
|
|
91
|
-
|
|
92
|
-
|
|
94
|
+
Matching tolerates legal forms ('GmbH & Co. KG'), punctuation ('M.B. MUSTERMANN' vs
|
|
95
|
+
'MB Mustermann'), umlauts, and word order.
|
|
93
96
|
|
|
94
97
|
Args:
|
|
95
98
|
- query (string): what to search for. A company name, surname, email or customer number.
|
|
99
|
+
- contact_type ('CUSTOMER'|'SUPPLIER'): restrict to customers or suppliers. Omit for both.
|
|
96
100
|
- limit (number): max candidates to return, 1-25 (default 5).
|
|
97
|
-
- min_score (number): 0-1 match threshold (default 0.5).
|
|
98
|
-
- max_pages (number):
|
|
99
|
-
Each page is one API request, so keep this low on a plan with a 10 req/min limit.
|
|
101
|
+
- min_score (number): 0-1 match threshold for the fuzzy fallback (default 0.5).
|
|
102
|
+
- max_pages (number): pages of 1000 customers to scan in the fallback (default 3).
|
|
100
103
|
|
|
101
104
|
Returns: { query, match_count, exact_match (boolean), candidates[] } where each candidate has
|
|
102
105
|
its easybill 'id', 'match_score' (1 = certain) and the usual summary fields.
|
|
@@ -117,6 +120,10 @@ Examples:
|
|
|
117
120
|
.min(2, "Query must be at least 2 characters")
|
|
118
121
|
.max(200)
|
|
119
122
|
.describe("Company name, person name, email address, customer number or city."),
|
|
123
|
+
contact_type: z
|
|
124
|
+
.enum(["CUSTOMER", "SUPPLIER"])
|
|
125
|
+
.optional()
|
|
126
|
+
.describe("Only customers or only suppliers. Omit to search both."),
|
|
120
127
|
limit: z.number().int().min(1).max(25).default(5).describe("Max candidates to return."),
|
|
121
128
|
min_score: z
|
|
122
129
|
.number()
|
|
@@ -140,6 +147,31 @@ Examples:
|
|
|
140
147
|
const maxPages = args.max_pages;
|
|
141
148
|
const format = args.response_format ?? "markdown";
|
|
142
149
|
const queryTokens = tokenize(query);
|
|
150
|
+
const contactType = args.contact_type;
|
|
151
|
+
// --- Full-text search: one request ---
|
|
152
|
+
try {
|
|
153
|
+
const found = await client.request("/customers/search", {
|
|
154
|
+
query: { query, limit: 100, ...(contactType ? { contactType } : {}) },
|
|
155
|
+
});
|
|
156
|
+
const ranked = (found?.items ?? [])
|
|
157
|
+
.map((customer) => ({ customer, value: score(customer, queryTokens, query) }))
|
|
158
|
+
.sort((a, b) => b.value - a.value);
|
|
159
|
+
const candidates = ranked.slice(0, limit).map(({ customer, value }) => ({
|
|
160
|
+
...selectFields(customer, SUMMARY_FIELDS.customer),
|
|
161
|
+
match_score: Math.round(value * 100) / 100,
|
|
162
|
+
matched_by: "full-text search",
|
|
163
|
+
}));
|
|
164
|
+
const certain = candidates.filter((c) => c.match_score === 1).length === 1 && candidates[0]?.match_score === 1;
|
|
165
|
+
const total = found?.total ?? ranked.length;
|
|
166
|
+
return render(query, candidates, certain, format, `easybill full-text search, ${total} hit(s)${total > limit ? `, best ${candidates.length} shown` : ""}`);
|
|
167
|
+
}
|
|
168
|
+
catch (error) {
|
|
169
|
+
// Older API or no permission for the search endpoint: use the fallback below.
|
|
170
|
+
const unavailable = error instanceof EasybillApiError && [400, 403, 404, 405].includes(error.status);
|
|
171
|
+
if (!unavailable)
|
|
172
|
+
throw error;
|
|
173
|
+
}
|
|
174
|
+
// --- Fallback: exact filters, then a local fuzzy scan ---
|
|
143
175
|
const looksLikeEmail = query.includes("@");
|
|
144
176
|
const looksLikeNumber = /^\d+$/.test(query);
|
|
145
177
|
// --- Phase 1: cheap exact filters (1 request each, only where plausible) ---
|
|
@@ -152,7 +184,7 @@ Examples:
|
|
|
152
184
|
exactAttempts.push({ field: "company_name", value: query });
|
|
153
185
|
for (const attempt of exactAttempts) {
|
|
154
186
|
const hit = await client.request("/customers", {
|
|
155
|
-
query: { [attempt.field]: attempt.value, limit: limit },
|
|
187
|
+
query: { [attempt.field]: attempt.value, limit: limit, ...(contactType ? { contactType } : {}) },
|
|
156
188
|
});
|
|
157
189
|
const items = hit?.items ?? [];
|
|
158
190
|
if (items.length > 0) {
|
|
@@ -170,7 +202,7 @@ Examples:
|
|
|
170
202
|
let totalCustomers = 0;
|
|
171
203
|
for (let page = 1; page <= maxPages; page++) {
|
|
172
204
|
const list = await client.request("/customers", {
|
|
173
|
-
query: { limit: 1000, page },
|
|
205
|
+
query: { limit: 1000, page, ...(contactType ? { contactType } : {}) },
|
|
174
206
|
});
|
|
175
207
|
pagesScanned++;
|
|
176
208
|
totalCustomers = list?.total ?? 0;
|
package/dist/tools/search.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}
|
package/dist/tools/work.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
/** Projects and time tracking. */
|
|
2
2
|
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
3
|
-
import type {
|
|
4
|
-
export declare function registerWorkTools(server: McpServer, client:
|
|
3
|
+
import type { ApiClient } from "../services/client.js";
|
|
4
|
+
export declare function registerWorkTools(server: McpServer, client: ApiClient): void;
|
package/dist/tools/work.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"work.js","sourceRoot":"","sources":["../../src/tools/work.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAGlC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,
|
|
1
|
+
{"version":3,"file":"work.js","sourceRoot":"","sources":["../../src/tools/work.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAGlC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAiB;IACpE,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE;QAChC,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,UAAU;QAClB,YAAY,EAAE,SAAS;QACvB,UAAU,EAAE,UAAU;QACtB,IAAI,EAAE,WAAW;QACjB,aAAa,EAAE,cAAc,CAAC,OAAO;QACrC,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;QACzD,SAAS,EACP,0FAA0F;YAC1F,sEAAsE;YACtE,yEAAyE;YACzE,sDAAsD;QACxD,QAAQ,EAAE;;;;;;;;;;;;;;2CAc6B;QACvC,OAAO,EAAE;YACP,WAAW,EAAE,WAAW,CAAC,wBAAwB,CAAC;YAClD,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;iBAChC,QAAQ,EAAE;iBACV,QAAQ,CAAC,2BAA2B,CAAC;SACzC;KACF,CAAC,CAAC;IAEH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE;QAChC,QAAQ,EAAE,qBAAqB;QAC/B,MAAM,EAAE,uBAAuB;QAC/B,YAAY,EAAE,eAAe;QAC7B,UAAU,EAAE,gBAAgB;QAC5B,IAAI,EAAE,iBAAiB;QACvB,aAAa,EAAE,cAAc,CAAC,YAAY;QAC1C,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;QACzD,SAAS,EACP,0FAA0F;YAC1F,8DAA8D;YAC9D,0FAA0F;YAC1F,mEAAmE;QACrE,QAAQ,EAAE;;;;;;;;;;;;;iEAamD;QAC7D,OAAO,EAAE;YACP,UAAU,EAAE,WAAW,CAAC,uBAAuB,CAAC;YAChD,QAAQ,EAAE,WAAW,CAAC,gEAAgE,CAAC;YACvF,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC;YACtC,YAAY,EAAE,UAAU,CAAC,UAAU,CAAC;SACrC;KACF,CAAC,CAAC;AACL,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "easybill-mcp",
|
|
3
|
-
"version": "1.0
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "MCP server for the easybill REST API (invoices, customers, articles, payments, time tracking)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"start": "node dist/index.js",
|
|
19
19
|
"dev": "tsx watch src/index.ts",
|
|
20
20
|
"typecheck": "tsc --noEmit",
|
|
21
|
-
"test": "npm run build && node --test test/format.test.mjs test/client.test.mjs test/rate-limit.test.mjs test/server.test.mjs",
|
|
21
|
+
"test": "npm run build && node --test test/format.test.mjs test/client.test.mjs test/rate-limit.test.mjs test/server.test.mjs test/hosted.test.mjs test/hosted-apikey.test.mjs test/hosted-access.test.mjs test/stdio-files.test.mjs",
|
|
22
22
|
"test:live": "npm run build && node --env-file=.env --test test/live.test.mjs",
|
|
23
23
|
"test:all": "npm run test && npm run test:live",
|
|
24
24
|
"smoke": "node --env-file=.env dist/index.js --selftest",
|
|
@@ -62,9 +62,12 @@
|
|
|
62
62
|
},
|
|
63
63
|
"dependencies": {
|
|
64
64
|
"@modelcontextprotocol/sdk": "^1.30.0",
|
|
65
|
+
"express": "^5.2.1",
|
|
66
|
+
"jose": "^6.2.8",
|
|
65
67
|
"zod": "^4.4.3"
|
|
66
68
|
},
|
|
67
69
|
"devDependencies": {
|
|
70
|
+
"@types/express": "^5.0.6",
|
|
68
71
|
"@types/node": "^22.10.0",
|
|
69
72
|
"tsx": "^4.19.2",
|
|
70
73
|
"typescript": "^5.7.2"
|