@kelviq/mcp-server 0.2.3 → 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/README.md +26 -23
- package/dist/config.d.ts +9 -1
- package/dist/config.js +38 -7
- package/dist/config.js.map +1 -1
- package/dist/docs/api-reference/authentication.md +7 -3
- package/dist/docs/api-reference/introduction.md +143 -0
- package/dist/docs/backend-integration/node-sdk.md +148 -6
- package/dist/docs/backend-integration/python-sdk.md +195 -11
- package/dist/docs/changelog/api.md +119 -0
- package/dist/docs/changelog/app.md +693 -0
- package/dist/docs/changelog/mcp-server.md +61 -0
- package/dist/docs/changelog/node-sdk.md +153 -0
- package/dist/docs/changelog/python-sdk.md +182 -0
- package/dist/docs/cli/commands.md +225 -0
- package/dist/docs/cli/environments.md +95 -0
- package/dist/docs/cli/kelviq-config.md +141 -0
- package/dist/docs/cli/overview.md +223 -0
- package/dist/docs/customer-portal/managing-payment-methods.md +72 -0
- package/dist/docs/guides/mcp-server.md +141 -194
- package/dist/docs/guides/sandbox.md +107 -0
- package/dist/docs/guides/webhooks.md +81 -0
- package/dist/docs/manifest.json +64 -8
- package/dist/docs/openapi.json +1206 -50
- package/dist/docs/product-catalog/one-time-payments.md +3 -1
- package/dist/docs/product-catalog/usage-based-billing.md +86 -7
- package/dist/docs/quickstart/dashboard-setup.md +1 -1
- package/dist/prompts/index.d.ts +2 -0
- package/dist/prompts/index.js +107 -0
- package/dist/prompts/index.js.map +1 -0
- package/dist/schemas/kelviq.d.ts +30 -128
- package/dist/schemas/kelviq.js +50 -63
- package/dist/schemas/kelviq.js.map +1 -1
- package/dist/server.js +5 -2
- package/dist/server.js.map +1 -1
- package/dist/tools/checkout.js +2 -1
- package/dist/tools/checkout.js.map +1 -1
- package/dist/tools/customers.js +2 -0
- package/dist/tools/customers.js.map +1 -1
- package/dist/tools/docs.js +2 -0
- package/dist/tools/docs.js.map +1 -1
- package/dist/tools/entitlements.js +1 -0
- package/dist/tools/entitlements.js.map +1 -1
- package/dist/tools/features.js +4 -0
- package/dist/tools/features.js.map +1 -1
- package/dist/tools/index.js +0 -4
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/licenses.js +3 -0
- package/dist/tools/licenses.js.map +1 -1
- package/dist/tools/offerings.js +1 -0
- package/dist/tools/offerings.js.map +1 -1
- package/dist/tools/plan-entitlements.js +4 -0
- package/dist/tools/plan-entitlements.js.map +1 -1
- package/dist/tools/plan-files.js +4 -1
- package/dist/tools/plan-files.js.map +1 -1
- package/dist/tools/plans.js +9 -15
- package/dist/tools/plans.js.map +1 -1
- package/dist/tools/portal.d.ts +11 -1
- package/dist/tools/portal.js +28 -2
- package/dist/tools/portal.js.map +1 -1
- package/dist/tools/product-files.js +2 -0
- package/dist/tools/product-files.js.map +1 -1
- package/dist/tools/product-settings.js +2 -0
- package/dist/tools/product-settings.js.map +1 -1
- package/dist/tools/products.js +6 -1
- package/dist/tools/products.js.map +1 -1
- package/dist/tools/promotions.js +1 -0
- package/dist/tools/promotions.js.map +1 -1
- package/dist/tools/subscriptions.js +6 -2
- package/dist/tools/subscriptions.js.map +1 -1
- package/dist/tools/usage.js +1 -0
- package/dist/tools/usage.js.map +1 -1
- package/package.json +5 -2
|
@@ -4,6 +4,7 @@ export function registerProductFileTools(server, http) {
|
|
|
4
4
|
server.registerTool('product_image_update', {
|
|
5
5
|
title: 'Update product image',
|
|
6
6
|
description: 'Edit display fields of a product image (name, ordering, thumbnail flag, enabled). The underlying file cannot be replaced — upload a new image instead.',
|
|
7
|
+
annotations: { destructiveHint: false, idempotentHint: true },
|
|
7
8
|
inputSchema: ProductImageUpdate.shape,
|
|
8
9
|
}, async (input) => {
|
|
9
10
|
const { productId, imageId, ...body } = input;
|
|
@@ -18,6 +19,7 @@ export function registerProductFileTools(server, http) {
|
|
|
18
19
|
server.registerTool('product_image_delete', {
|
|
19
20
|
title: 'Delete product image',
|
|
20
21
|
description: 'Permanently remove an image from a product.',
|
|
22
|
+
annotations: { destructiveHint: true, idempotentHint: true },
|
|
21
23
|
inputSchema: ProductImageDelete.shape,
|
|
22
24
|
}, async (input) => {
|
|
23
25
|
const result = await http.request({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"product-files.js","sourceRoot":"","sources":["../../src/tools/product-files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,IAAsB;IAChF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,wJAAwJ;QAC1J,WAAW,EAAE,kBAAkB,CAAC,KAAK;KACtC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,qBAAqB,kBAAkB,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,OAAO,CAAC,GAAG;YAChG,IAAI;YACJ,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE,kBAAkB,CAAC,KAAK;KACtC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,qBAAqB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG;YAC5G,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
1
|
+
{"version":3,"file":"product-files.js","sourceRoot":"","sources":["../../src/tools/product-files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,IAAsB;IAChF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,wJAAwJ;QAC1J,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE;QAC7D,WAAW,EAAE,kBAAkB,CAAC,KAAK;KACtC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,qBAAqB,kBAAkB,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,OAAO,CAAC,GAAG;YAChG,IAAI;YACJ,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;QAC5D,WAAW,EAAE,kBAAkB,CAAC,KAAK;KACtC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,qBAAqB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG;YAC5G,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
@@ -4,6 +4,7 @@ export function registerProductSettingsTools(server, http) {
|
|
|
4
4
|
server.registerTool('product_settings_get', {
|
|
5
5
|
title: 'Get product settings',
|
|
6
6
|
description: 'Retrieve product settings (VPN/Tor/proxy policy, default currency, product URL).',
|
|
7
|
+
annotations: { readOnlyHint: true },
|
|
7
8
|
inputSchema: ProductSettingsGet.shape,
|
|
8
9
|
}, async (input) => {
|
|
9
10
|
const result = await http.request({
|
|
@@ -16,6 +17,7 @@ export function registerProductSettingsTools(server, http) {
|
|
|
16
17
|
server.registerTool('product_settings_update', {
|
|
17
18
|
title: 'Update product settings',
|
|
18
19
|
description: 'Patch product settings. Any subset of fields may be supplied; missing fields are left unchanged.',
|
|
20
|
+
annotations: { destructiveHint: false, idempotentHint: true },
|
|
19
21
|
inputSchema: ProductSettingsUpdate.shape,
|
|
20
22
|
}, async (input) => {
|
|
21
23
|
const { productId, ...body } = input;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"product-settings.js","sourceRoot":"","sources":["../../src/tools/product-settings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,IAAsB;IACpF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,kFAAkF;QACpF,WAAW,EAAE,kBAAkB,CAAC,KAAK;KACtC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,qBAAqB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,YAAY;YAC1E,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,kGAAkG;QACpG,WAAW,EAAE,qBAAqB,CAAC,KAAK;KACzC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,qBAAqB,kBAAkB,CAAC,SAAS,CAAC,YAAY;YACpE,IAAI;YACJ,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
1
|
+
{"version":3,"file":"product-settings.js","sourceRoot":"","sources":["../../src/tools/product-settings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,4BAA4B,CAAC,MAAiB,EAAE,IAAsB;IACpF,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,kFAAkF;QACpF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,WAAW,EAAE,kBAAkB,CAAC,KAAK;KACtC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,qBAAqB,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,YAAY;YAC1E,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,kGAAkG;QACpG,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE;QAC7D,WAAW,EAAE,qBAAqB,CAAC,KAAK;KACzC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,qBAAqB,kBAAkB,CAAC,SAAS,CAAC,YAAY;YACpE,IAAI;YACJ,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;AACJ,CAAC"}
|
package/dist/tools/products.js
CHANGED
|
@@ -4,6 +4,7 @@ export function registerProductTools(server, http) {
|
|
|
4
4
|
server.registerTool('product_list', {
|
|
5
5
|
title: 'List products',
|
|
6
6
|
description: 'List catalog products. Optional `search` filters by name/identifier substring; `page` paginates.',
|
|
7
|
+
annotations: { readOnlyHint: true },
|
|
7
8
|
inputSchema: ListProducts.shape,
|
|
8
9
|
}, async (input) => {
|
|
9
10
|
const result = await http.request({
|
|
@@ -16,7 +17,8 @@ export function registerProductTools(server, http) {
|
|
|
16
17
|
});
|
|
17
18
|
server.registerTool('product_create', {
|
|
18
19
|
title: 'Create product',
|
|
19
|
-
description: 'Create a new catalog product. Required: `name` and `taxCode`. `identifier` is auto-generated from `name` if omitted. `imageKeys` are tmp S3 keys
|
|
20
|
+
description: 'Create a new catalog product. Required: `name` and `taxCode`. `identifier` is auto-generated from `name` if omitted. `imageKeys` are tmp S3 keys returned by the Kelviq media upload endpoint (`POST /media/`).',
|
|
21
|
+
annotations: { destructiveHint: false, idempotentHint: false },
|
|
20
22
|
inputSchema: ProductCreate.shape,
|
|
21
23
|
}, async (input) => {
|
|
22
24
|
const result = await http.request({
|
|
@@ -30,6 +32,7 @@ export function registerProductTools(server, http) {
|
|
|
30
32
|
server.registerTool('product_retrieve', {
|
|
31
33
|
title: 'Retrieve product',
|
|
32
34
|
description: 'Fetch a single catalog product by UUID or identifier.',
|
|
35
|
+
annotations: { readOnlyHint: true },
|
|
33
36
|
inputSchema: ProductRetrieve.shape,
|
|
34
37
|
}, async (input) => {
|
|
35
38
|
const result = await http.request({
|
|
@@ -42,6 +45,7 @@ export function registerProductTools(server, http) {
|
|
|
42
45
|
server.registerTool('product_update', {
|
|
43
46
|
title: 'Update product',
|
|
44
47
|
description: 'Patch an existing product. Only the fields you pass are updated.',
|
|
48
|
+
annotations: { destructiveHint: false, idempotentHint: true },
|
|
45
49
|
inputSchema: ProductUpdate.shape,
|
|
46
50
|
}, async (input) => {
|
|
47
51
|
const { productId, ...body } = input;
|
|
@@ -56,6 +60,7 @@ export function registerProductTools(server, http) {
|
|
|
56
60
|
server.registerTool('product_archive', {
|
|
57
61
|
title: 'Archive product',
|
|
58
62
|
description: 'Archive a catalog product. Archived products stop being purchasable but historical subscriptions/orders are preserved.',
|
|
63
|
+
annotations: { destructiveHint: true, idempotentHint: true },
|
|
59
64
|
inputSchema: ProductArchive.shape,
|
|
60
65
|
}, async (input) => {
|
|
61
66
|
const result = await http.request({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/tools/products.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,IAAsB;IAC5E,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,kGAAkG;QACpG,WAAW,EAAE,YAAY,CAAC,KAAK;KAChC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,oBAAoB;YAC1B,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;SAClD,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,
|
|
1
|
+
{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/tools/products.ts"],"names":[],"mappings":"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"}
|
package/dist/tools/promotions.js
CHANGED
|
@@ -4,6 +4,7 @@ export function registerPromotionTools(server, http) {
|
|
|
4
4
|
server.registerTool('promotion_get', {
|
|
5
5
|
title: 'Get promotion',
|
|
6
6
|
description: 'Resolve the active promotion for the caller\'s detected location. Returns discount percentage, coupon code, banner widget config, and security checks (proxy/VPN/Tor). NOTE: this tool authenticates with your Client API Key (KELVIQ_CLIENT_API_KEY), not the Server API Key.',
|
|
7
|
+
annotations: { readOnlyHint: true },
|
|
7
8
|
inputSchema: GetPromotion.shape,
|
|
8
9
|
}, async (input) => {
|
|
9
10
|
const result = await http.request({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"promotions.js","sourceRoot":"","sources":["../../src/tools/promotions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,IAAsB;IAC9E,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,gRAAgR;QAClR,WAAW,EAAE,YAAY,CAAC,KAAK;KAChC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE;SAC3C,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
1
|
+
{"version":3,"file":"promotions.js","sourceRoot":"","sources":["../../src/tools/promotions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,IAAsB;IAC9E,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,gRAAgR;QAClR,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,WAAW,EAAE,YAAY,CAAC,KAAK;KAChC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE;SAC3C,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
@@ -3,7 +3,8 @@ import { resultToContent } from './_util.js';
|
|
|
3
3
|
export function registerSubscriptionTools(server, http) {
|
|
4
4
|
server.registerTool('subscription_create', {
|
|
5
5
|
title: 'Create subscription',
|
|
6
|
-
description: 'Create a subscription directly for a customer, bypassing hosted checkout. Use when the customer has already been collected externally. For free plans pass chargePeriod=ONE_TIME. To upgrade from a free plan, use checkout_create_session instead.',
|
|
6
|
+
description: 'Create a subscription directly for a customer, bypassing hosted checkout. Use when the customer has already been collected externally. For free plans pass chargePeriod=ONE_TIME. To upgrade from a free plan, use checkout_create_session instead. Requires off-session charging to be enabled for the organization; if the API rejects the call for that reason, use checkout_create_session (hosted checkout, the customer completes payment themselves) instead.',
|
|
7
|
+
annotations: { destructiveHint: false, idempotentHint: false },
|
|
7
8
|
inputSchema: CreateSubscription.shape,
|
|
8
9
|
}, async (input) => {
|
|
9
10
|
const result = await http.request({
|
|
@@ -17,6 +18,7 @@ export function registerSubscriptionTools(server, http) {
|
|
|
17
18
|
server.registerTool('subscription_list', {
|
|
18
19
|
title: 'List subscriptions',
|
|
19
20
|
description: 'List subscriptions, optionally filtered by customerId. Paginated via `page` and `pageSize`. Returns { count, next, previous, results }.',
|
|
21
|
+
annotations: { readOnlyHint: true },
|
|
20
22
|
inputSchema: ListSubscriptions.shape,
|
|
21
23
|
}, async (input) => {
|
|
22
24
|
const result = await http.request({
|
|
@@ -33,7 +35,8 @@ export function registerSubscriptionTools(server, http) {
|
|
|
33
35
|
});
|
|
34
36
|
server.registerTool('subscription_update', {
|
|
35
37
|
title: 'Update subscription',
|
|
36
|
-
description: 'Change plan, charge period, and/or features for an existing subscription. Note: free plans are one-time charges — to upgrade from free, use checkout_create_session instead.',
|
|
38
|
+
description: 'Change plan, charge period, and/or features for an existing subscription. Note: free plans are one-time charges — to upgrade from free, use checkout_create_session instead. Pass paymentBehavior "activate_on_payment" to keep the current subscription active until payment succeeds before applying the change.',
|
|
39
|
+
annotations: { destructiveHint: false, idempotentHint: true },
|
|
37
40
|
inputSchema: UpdateSubscription.shape,
|
|
38
41
|
}, async (input) => {
|
|
39
42
|
const { subscriptionId, ...body } = input;
|
|
@@ -48,6 +51,7 @@ export function registerSubscriptionTools(server, http) {
|
|
|
48
51
|
server.registerTool('subscription_cancel', {
|
|
49
52
|
title: 'Cancel subscription',
|
|
50
53
|
description: 'Cancel a subscription. cancellationType: IMMEDIATE | CURRENT_PERIOD_ENDS | SPECIFIC_DATE. Pass cancellationDate (YYYY-MM-DD) only when type is SPECIFIC_DATE.',
|
|
54
|
+
annotations: { destructiveHint: true, idempotentHint: true },
|
|
51
55
|
inputSchema: CancelSubscription.shape,
|
|
52
56
|
}, async (input) => {
|
|
53
57
|
const { subscriptionId, ...body } = input;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/tools/subscriptions.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,IAAsB;IACjF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,
|
|
1
|
+
{"version":3,"file":"subscriptions.js","sourceRoot":"","sources":["../../src/tools/subscriptions.ts"],"names":[],"mappings":"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"}
|
package/dist/tools/usage.js
CHANGED
|
@@ -4,6 +4,7 @@ export function registerUsageTools(server, http) {
|
|
|
4
4
|
server.registerTool('usage_report', {
|
|
5
5
|
title: 'Report feature usage',
|
|
6
6
|
description: 'Report a usage value for a metered feature. behaviour=SET replaces the current value; behaviour=DELTA increments by `value`. Returns a server-generated idempotencyKey + timestamp.',
|
|
7
|
+
annotations: { destructiveHint: false, idempotentHint: false },
|
|
7
8
|
inputSchema: ReportUsage.shape,
|
|
8
9
|
}, async (input) => {
|
|
9
10
|
const result = await http.request({
|
package/dist/tools/usage.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,IAAsB;IAC1E,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,qLAAqL;QACvL,WAAW,EAAE,WAAW,CAAC,KAAK;KAC/B,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
1
|
+
{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,IAAsB;IAC1E,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,qLAAqL;QACvL,WAAW,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE;QAC9D,WAAW,EAAE,WAAW,CAAC,KAAK;KAC/B,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QACH,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;AACJ,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kelviq/mcp-server",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Model Context Protocol server for Kelviq — typed tools for the Kelviq API plus searchable documentation resources.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Kelviq <hi@kelviq.com>",
|
|
@@ -48,6 +48,8 @@
|
|
|
48
48
|
"start": "node dist/server.js",
|
|
49
49
|
"dev": "tsx src/server.ts",
|
|
50
50
|
"inspect": "npx -y @modelcontextprotocol/inspector node dist/server.js",
|
|
51
|
+
"test": "vitest run",
|
|
52
|
+
"test:watch": "vitest",
|
|
51
53
|
"release": "./scripts/publish.sh",
|
|
52
54
|
"release:beta": "./scripts/publish.sh --beta",
|
|
53
55
|
"release:dry-run": "./scripts/publish.sh --dry-run",
|
|
@@ -83,6 +85,7 @@
|
|
|
83
85
|
"lint-staged": "^16.4.0",
|
|
84
86
|
"tsx": "^4.19.0",
|
|
85
87
|
"typescript": "^5.6.0",
|
|
86
|
-
"typescript-eslint": "^8.61.1"
|
|
88
|
+
"typescript-eslint": "^8.61.1",
|
|
89
|
+
"vitest": "^4.1.10"
|
|
87
90
|
}
|
|
88
91
|
}
|