@kelviq/mcp-server 0.2.0 → 0.2.3
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 +13 -9
- package/dist/config.d.ts +0 -1
- package/dist/config.js +6 -4
- package/dist/config.js.map +1 -1
- package/dist/docs/guides/mcp-server.md +418 -0
- package/dist/docs/manifest.json +7 -0
- package/dist/docs/openapi.json +2 -2
- package/dist/http/client.d.ts +1 -1
- package/dist/http/client.js +1 -5
- package/dist/http/client.js.map +1 -1
- package/dist/server.js +2 -2
- package/dist/server.js.map +1 -1
- package/dist/tools/entitlements.js +1 -1
- package/dist/tools/entitlements.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -29,11 +29,16 @@ npx -y @kelviq/mcp-server
|
|
|
29
29
|
### Claude Code (CLI)
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
|
-
claude mcp add kelviq
|
|
32
|
+
claude mcp add kelviq \
|
|
33
33
|
--env KELVIQ_SERVER_API_KEY=<your-server-key> \
|
|
34
|
-
--env KELVIQ_CLIENT_API_KEY=<your-client-key>
|
|
34
|
+
--env KELVIQ_CLIENT_API_KEY=<your-client-key> \
|
|
35
|
+
-- npx -y @kelviq/mcp-server
|
|
35
36
|
```
|
|
36
37
|
|
|
38
|
+
> The `--` separator is required: it tells `claude` that everything after
|
|
39
|
+
> it is the command + its args, so flags like `-y` aren't intercepted by
|
|
40
|
+
> the `claude` CLI itself. Put all `--env` flags **before** the `--`.
|
|
41
|
+
|
|
37
42
|
Then `/mcp` in a new Claude Code session shows `kelviq` connected.
|
|
38
43
|
|
|
39
44
|
### Claude Desktop
|
|
@@ -77,16 +82,14 @@ key). Docs tools (`docs_search`, `docs_read`) work with no keys at all.
|
|
|
77
82
|
| Variable | Required | Default | Purpose |
|
|
78
83
|
|---|---|---|---|
|
|
79
84
|
| `KELVIQ_SERVER_API_KEY` | yes (for API tools) | — | Bearer token for `api.kelviq.com` |
|
|
80
|
-
| `KELVIQ_CLIENT_API_KEY` | only for `promotion_get` | — | Bearer token for
|
|
85
|
+
| `KELVIQ_CLIENT_API_KEY` | only for `promotion_get` | — | Bearer token for the edge host |
|
|
81
86
|
| `KELVIQ_BASE_URL` | no | `https://api.kelviq.com/api/v1` | Override (sandbox, self-host) |
|
|
82
|
-
| `
|
|
83
|
-
| `KELVIQ_EDGE_URL` | no | `https://edge.kelviq.com/api/v1` | Override promotions edge host |
|
|
87
|
+
| `KELVIQ_EDGE_URL` | no | `https://edge.api.kelviq.com/api/v1` | Override the edge host (entitlements + promotions) |
|
|
84
88
|
|
|
85
89
|
To point at Kelviq staging:
|
|
86
90
|
|
|
87
91
|
```
|
|
88
92
|
KELVIQ_BASE_URL=https://stagingapi.kelviq.com/api/v1
|
|
89
|
-
KELVIQ_ENTITLEMENTS_URL=https://edge.stagingapi.kelviq.com
|
|
90
93
|
KELVIQ_EDGE_URL=https://edge.stagingapi.kelviq.com/api/v1
|
|
91
94
|
```
|
|
92
95
|
|
|
@@ -211,9 +214,10 @@ PATH. Either:
|
|
|
211
214
|
|
|
212
215
|
2. **Use the absolute path** in the `claude mcp add` command:
|
|
213
216
|
```bash
|
|
214
|
-
claude mcp add kelviq
|
|
215
|
-
|
|
216
|
-
--
|
|
217
|
+
claude mcp add kelviq \
|
|
218
|
+
--env KELVIQ_SERVER_API_KEY=... \
|
|
219
|
+
-- /Users/you/.nvm/versions/node/v20.19.0/bin/node \
|
|
220
|
+
$(npm root -g)/@kelviq/mcp-server/dist/server.js
|
|
217
221
|
```
|
|
218
222
|
|
|
219
223
|
3. **Install node via Homebrew** (`brew install node`) so it lives on the
|
package/dist/config.d.ts
CHANGED
package/dist/config.js
CHANGED
|
@@ -1,14 +1,16 @@
|
|
|
1
1
|
const DEFAULT_BASE_URL = 'https://api.kelviq.com/api/v1';
|
|
2
|
-
const DEFAULT_EDGE_URL = 'https://edge.kelviq.com/api/v1';
|
|
3
|
-
const DEFAULT_ENTITLEMENTS_URL = 'https://edge.api.kelviq.com';
|
|
2
|
+
const DEFAULT_EDGE_URL = 'https://edge.api.kelviq.com/api/v1';
|
|
4
3
|
export function loadConfig(env = process.env) {
|
|
5
4
|
const stripSlash = (u) => u.replace(/\/+$/, '');
|
|
5
|
+
// KELVIQ_ENTITLEMENTS_URL is honored as a legacy alias so existing configs
|
|
6
|
+
// don't break, but KELVIQ_EDGE_URL is the canonical name now that
|
|
7
|
+
// entitlements and promotions share a single edge host.
|
|
8
|
+
const edgeOverride = env.KELVIQ_EDGE_URL?.trim() || env.KELVIQ_ENTITLEMENTS_URL?.trim() || DEFAULT_EDGE_URL;
|
|
6
9
|
return {
|
|
7
10
|
serverApiKey: env.KELVIQ_SERVER_API_KEY?.trim() || undefined,
|
|
8
11
|
clientApiKey: env.KELVIQ_CLIENT_API_KEY?.trim() || undefined,
|
|
9
12
|
baseUrl: stripSlash(env.KELVIQ_BASE_URL?.trim() || DEFAULT_BASE_URL),
|
|
10
|
-
edgeUrl: stripSlash(
|
|
11
|
-
entitlementsUrl: stripSlash(env.KELVIQ_ENTITLEMENTS_URL?.trim() || DEFAULT_ENTITLEMENTS_URL),
|
|
13
|
+
edgeUrl: stripSlash(edgeOverride),
|
|
12
14
|
userAgent: `kelviq-mcp/${getPackageVersion()} (+https://kelviq.com)`,
|
|
13
15
|
};
|
|
14
16
|
}
|
package/dist/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAUA,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AACzD,MAAM,gBAAgB,GAAG,oCAAoC,CAAC;AAE9D,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxD,2EAA2E;IAC3E,kEAAkE;IAClE,wDAAwD;IACxD,MAAM,YAAY,GAChB,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC;IACzF,OAAO;QACL,YAAY,EAAE,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,IAAI,SAAS;QAC5D,YAAY,EAAE,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,IAAI,SAAS;QAC5D,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC;QACpE,OAAO,EAAE,UAAU,CAAC,YAAY,CAAC;QACjC,SAAS,EAAE,cAAc,iBAAiB,EAAE,wBAAwB;KACrE,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAyB,CAAC;QAC/D,OAAO,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAoB,EAAE,KAAgB;IAC/D,MAAM,GAAG,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;IAC3E,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,uBAAuB,CAAC;QACtF,MAAM,IAAI,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACZ;IAAgC;IAA5D,YAA4B,MAAc,EAAkB,KAAgB;QAC1E,KAAK,CACH,WAAW,MAAM,gDAAgD,KAAK,4BAA4B;YAChG,uDAAuD,CAC1D,CAAC;QAJwB,WAAM,GAAN,MAAM,CAAQ;QAAkB,UAAK,GAAL,KAAK,CAAW;QAK1E,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}
|
|
@@ -0,0 +1,418 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "MCP Server"
|
|
3
|
+
slug: "guides/mcp-server"
|
|
4
|
+
section: "guides"
|
|
5
|
+
description: "Control Kelviq from Claude, Cursor, and any AI assistant that speaks the Model Context Protocol."
|
|
6
|
+
---
|
|
7
|
+
`@kelviq/mcp-server` is the official [Model Context Protocol](https://modelcontextprotocol.io) server for Kelviq. It plugs into any MCP-compatible client — Claude Code, Claude Desktop, Cursor, Zed — and exposes the full Kelviq API as **typed tools** that the LLM can call directly, plus the entire Kelviq documentation as **searchable resources**.
|
|
8
|
+
|
|
9
|
+
In other words: instead of asking an assistant to "write me a curl command," you tell it *"create a Pro plan under product X and publish it"* and it does the work in one turn.
|
|
10
|
+
|
|
11
|
+
**51 tools across 13 domains** (customers, checkout, subscriptions, entitlements, licenses, usage, offerings, promotions, portal, catalog products, catalog plans, catalog features, partner organizations) plus **61 resources** including the full OpenAPI spec.
|
|
12
|
+
|
|
13
|
+
The package is open-source ([github.com/kelviq/kelviq-mcp-server](https://github.com/kelviq/kelviq-mcp-server), MIT) and published as `@kelviq/mcp-server` on npm.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## How It Works
|
|
18
|
+
|
|
19
|
+
The server runs locally on your machine as a Node process started by your AI client. It speaks the MCP **stdio transport** — your client launches `npx -y @kelviq/mcp-server` (or `node dist/server.js`), connects over stdio, and discovers the tools and resources advertised by the server.
|
|
20
|
+
|
|
21
|
+
When the LLM decides to call a Kelviq tool, the server:
|
|
22
|
+
|
|
23
|
+
1. Validates the LLM-provided arguments against a Zod schema derived from Kelviq's OpenAPI spec
|
|
24
|
+
2. Adds your API key as a Bearer token and sends the HTTPS request to the appropriate Kelviq host
|
|
25
|
+
3. Returns the JSON response (or a structured `{"error": {...}}` object) back to the LLM
|
|
26
|
+
|
|
27
|
+
API errors come back as content, not exceptions — the LLM reads them and reacts (re-tries with a fix, asks you to clarify, etc).
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Quickstart
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
Generate a **Server API Key** at [app.kelviq.com/settings/api-keys](https://app.kelviq.com/settings/api-keys). If you plan to use the `promotion_get` tool, also generate a **Client API Key**.
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
Never commit keys to git or paste them into shared chats. Use your MCP client's `env` configuration mechanism — most clients store them in their own credentials file.
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
Pick the tab that matches your client:
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
claude mcp add kelviq \
|
|
54
|
+
--env KELVIQ_SERVER_API_KEY=<your-server-key> \
|
|
55
|
+
--env KELVIQ_CLIENT_API_KEY=<your-client-key> \
|
|
56
|
+
-- npx -y @kelviq/mcp-server
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
The `--` separator is required so that `claude` doesn't intercept `-y` as one of its own flags. Put all `--env` arguments **before** the `--`.
|
|
60
|
+
|
|
61
|
+
Verify with `/mcp` inside a Claude Code session — you should see `kelviq ✓ Connected, 51 tools`.
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or the equivalent on your OS:
|
|
67
|
+
|
|
68
|
+
```json
|
|
69
|
+
{
|
|
70
|
+
"mcpServers": {
|
|
71
|
+
"kelviq": {
|
|
72
|
+
"command": "npx",
|
|
73
|
+
"args": ["-y", "@kelviq/mcp-server"],
|
|
74
|
+
"env": {
|
|
75
|
+
"KELVIQ_SERVER_API_KEY": "server-...",
|
|
76
|
+
"KELVIQ_CLIENT_API_KEY": "client-..."
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Restart Claude Desktop. The hammer icon shows `kelviq` with all tools.
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
Open **Cursor Settings → MCP**, click **Add new MCP server**, and configure:
|
|
89
|
+
|
|
90
|
+
- **Command:** `npx`
|
|
91
|
+
- **Args:** `-y @kelviq/mcp-server`
|
|
92
|
+
- **Environment Variables:** `KELVIQ_SERVER_API_KEY`, `KELVIQ_CLIENT_API_KEY`
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
Any client supporting stdio MCP servers works. Point it at the command:
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
npx -y @kelviq/mcp-server
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
with the env vars listed in [Environment Variables](#environment-variables) below.
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
In a new session, type a prompt like:
|
|
113
|
+
|
|
114
|
+
> *Search Kelviq docs for license keys.*
|
|
115
|
+
|
|
116
|
+
or
|
|
117
|
+
|
|
118
|
+
> *List my Kelviq products.*
|
|
119
|
+
|
|
120
|
+
Your AI client should pick the right tool, call it, and show the result inline. If you see a `Configuration error`, your env vars didn't make it through — check the snippet above.
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## Environment Variables
|
|
126
|
+
|
|
127
|
+
| Variable | Required | Default | Purpose |
|
|
128
|
+
|---|---|---|---|
|
|
129
|
+
| `KELVIQ_SERVER_API_KEY` | Yes, for all API tools | — | Bearer token for `api.kelviq.com` |
|
|
130
|
+
| `KELVIQ_CLIENT_API_KEY` | Only for `promotion_get` | — | Bearer token for the edge host |
|
|
131
|
+
| `KELVIQ_BASE_URL` | No | `https://api.kelviq.com/api/v1` | Override for sandbox / self-host |
|
|
132
|
+
| `KELVIQ_EDGE_URL` | No | `https://edge.api.kelviq.com/api/v1` | Override the edge host (entitlements + promotions) |
|
|
133
|
+
|
|
134
|
+
**Docs tools (`docs_search`, `docs_read`) work with no API keys at all.** Even without a key, the LLM can answer Kelviq questions from the bundled documentation.
|
|
135
|
+
|
|
136
|
+
### Point at staging
|
|
137
|
+
|
|
138
|
+
```
|
|
139
|
+
KELVIQ_BASE_URL=https://stagingapi.kelviq.com/api/v1
|
|
140
|
+
KELVIQ_EDGE_URL=https://edge.stagingapi.kelviq.com/api/v1
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Pair these with a **staging-scoped** Server API Key from your dashboard's staging environment.
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## Tool Reference
|
|
148
|
+
|
|
149
|
+
Tools are grouped by domain. Each tool name uses `domain_action` form (`customer_create`, `plan_publish`). The LLM picks the right tool from the description automatically — you rarely need to name a tool explicitly.
|
|
150
|
+
|
|
151
|
+
### Customers
|
|
152
|
+
|
|
153
|
+
| Tool | Description |
|
|
154
|
+
|---|---|
|
|
155
|
+
| `customer_create` | Create a customer. Required: `customerId`. Optional: `email`, `name`, `metadata`, `billingAddress`. |
|
|
156
|
+
| `customer_update` | Patch an existing customer by `customerId`. Only fields you pass are updated. |
|
|
157
|
+
|
|
158
|
+
### Checkout & Portal
|
|
159
|
+
|
|
160
|
+
| Tool | Description |
|
|
161
|
+
|---|---|
|
|
162
|
+
| `checkout_create_session` | Create a hosted checkout session. Returns `checkoutUrl` + `checkoutSessionId`. |
|
|
163
|
+
| `portal_session_create` | Mint a pre-authenticated customer portal URL. |
|
|
164
|
+
|
|
165
|
+
### Subscriptions
|
|
166
|
+
|
|
167
|
+
| Tool | Description |
|
|
168
|
+
|---|---|
|
|
169
|
+
| `subscription_create` | Create a subscription directly (skip checkout). |
|
|
170
|
+
| `subscription_list` | List subscriptions, filter by customer, paginated. |
|
|
171
|
+
| `subscription_update` | Change plan / charge period / features. Free plans must use `checkout_create_session` to upgrade. |
|
|
172
|
+
| `subscription_cancel` | Cancel `IMMEDIATE`, `CURRENT_PERIOD_ENDS`, or `SPECIFIC_DATE`. |
|
|
173
|
+
|
|
174
|
+
### Entitlements, Licenses, Usage
|
|
175
|
+
|
|
176
|
+
| Tool | Description |
|
|
177
|
+
|---|---|
|
|
178
|
+
| `entitlements_get` | Fetch entitlements for a customer. Pass `featureId` to scope. |
|
|
179
|
+
| `license_activate` | Activate a license key for a specific instance. Returns `instanceId`. |
|
|
180
|
+
| `license_deactivate` | Deactivate a license instance. |
|
|
181
|
+
| `license_validate` | Validate a license key (optionally bound to an instance). |
|
|
182
|
+
| `usage_report` | Report metered usage. `behaviour: SET` replaces, `DELTA` increments. |
|
|
183
|
+
|
|
184
|
+
### Offerings & Promotions
|
|
185
|
+
|
|
186
|
+
| Tool | Description |
|
|
187
|
+
|---|---|
|
|
188
|
+
| `offering_get_product` | Fetch public pricing scoped to a product UUID. Includes localized prices + customer subscription state. |
|
|
189
|
+
| `promotion_get` | Resolve the active promotion for the caller's location. Uses Client API key + edge host. |
|
|
190
|
+
|
|
191
|
+
### Catalog: Products
|
|
192
|
+
|
|
193
|
+
| Tool | Description |
|
|
194
|
+
|---|---|
|
|
195
|
+
| `product_list` | List catalog products. Optional `search` substring + `page`. |
|
|
196
|
+
| `product_create` | Create a product. Required: `name`, `taxCode`. Optional `imageKeys` from `media_presigned_upload`. |
|
|
197
|
+
| `product_retrieve` | Fetch one product by UUID or identifier. |
|
|
198
|
+
| `product_update` | Patch a product. |
|
|
199
|
+
| `product_archive` | Archive (soft-delete) a product. |
|
|
200
|
+
| `product_settings_get` | VPN / Tor / proxy policy, default currency, product URL. |
|
|
201
|
+
| `product_settings_update` | Patch any subset of those settings. |
|
|
202
|
+
| `product_image_update` | Edit display fields of a product image (`name`, `ordering`, `thumbnail`, `enabled`). |
|
|
203
|
+
| `product_image_delete` | Remove an image from a product. |
|
|
204
|
+
|
|
205
|
+
### Catalog: Features
|
|
206
|
+
|
|
207
|
+
| Tool | Description |
|
|
208
|
+
|---|---|
|
|
209
|
+
| `feature_list` | List catalog features. |
|
|
210
|
+
| `feature_create` | Create a feature. Required: `name`, `featureType` (`BOOLEAN` / `CUSTOMIZABLE` / `METER`). |
|
|
211
|
+
| `feature_retrieve` | Fetch one feature. |
|
|
212
|
+
| `feature_archive` | Archive a feature. Plans referencing it keep working. |
|
|
213
|
+
|
|
214
|
+
### Catalog: Plans
|
|
215
|
+
|
|
216
|
+
Plans are versioned: updates create a draft, `plan_publish` releases it.
|
|
217
|
+
|
|
218
|
+
| Tool | Description |
|
|
219
|
+
|---|---|
|
|
220
|
+
| `plan_list` | List all plans in the account. |
|
|
221
|
+
| `plan_create` | Create a plan under a product. Plan starts in `DRAFT`. |
|
|
222
|
+
| `plan_retrieve` | Fetch one plan. |
|
|
223
|
+
| `plan_update` | Patch a plan. Updates to a published plan automatically create a new draft. |
|
|
224
|
+
| `plan_archive` | Archive a plan. Existing subscriptions keep working. |
|
|
225
|
+
| `plan_publish` | Publish the latest draft. `updateFeatures` / `updatePricing` flags migrate existing customers. |
|
|
226
|
+
| `plan_discard_draft` | Drop the current draft, keep the published version. |
|
|
227
|
+
| `plan_prices_list` | List all prices configured on a plan. |
|
|
228
|
+
| `plan_prices_bulk_set` | Atomically replace all prices. Supports FLAT / PACKAGE / TIERED / VOLUME / STAIRSTEP models. |
|
|
229
|
+
| `plan_entitlements_list` | List feature entitlements on a plan. |
|
|
230
|
+
| `plan_entitlements_add` | Attach feature entitlements. |
|
|
231
|
+
| `plan_entitlement_update` | Patch a single entitlement's `details`. |
|
|
232
|
+
| `plan_entitlement_delete` | Remove an entitlement. |
|
|
233
|
+
| `plan_file_update` | Edit display fields of a plan-attached file. |
|
|
234
|
+
| `plan_file_delete` | Remove a file from a plan. |
|
|
235
|
+
| `plan_file_download` | Download URL/stream for a plan file (buyer-facing deliverables). |
|
|
236
|
+
|
|
237
|
+
### Media
|
|
238
|
+
|
|
239
|
+
| Tool | Description |
|
|
240
|
+
|---|---|
|
|
241
|
+
| `media_presigned_upload` | Get a presigned S3 POST policy (max 5 GB). Returns a `fileKey` to pass into `product_create`/`product_update` (`imageKeys`) or `plan_create`/`plan_update` (`fileKeys`). |
|
|
242
|
+
|
|
243
|
+
### Partner
|
|
244
|
+
|
|
245
|
+
| Tool | Description |
|
|
246
|
+
|---|---|
|
|
247
|
+
| `partner_org_provision` | Provision a Kelviq org under your partner account. Required: `externalId`, `email`. Optional `businessName`. |
|
|
248
|
+
| `partner_org_list` | List orgs you've provisioned. Optional `externalId` filter. |
|
|
249
|
+
| `partner_org_retrieve` | Fetch a partner org by its Kelviq identifier. |
|
|
250
|
+
| `partner_org_retrieve_by_external_id` | Fetch a partner org by your partner-side ID. |
|
|
251
|
+
|
|
252
|
+
### Docs (no API key required)
|
|
253
|
+
|
|
254
|
+
| Tool | Description |
|
|
255
|
+
|---|---|
|
|
256
|
+
| `docs_search` | Full-text search across the bundled Kelviq docs. Returns `{slug, title, snippet, score}`. |
|
|
257
|
+
| `docs_read` | Fetch a full markdown doc by slug. |
|
|
258
|
+
|
|
259
|
+
---
|
|
260
|
+
|
|
261
|
+
## Resources
|
|
262
|
+
|
|
263
|
+
Resources let your AI client pin pages into context. The server advertises three categories:
|
|
264
|
+
|
|
265
|
+
| URI pattern | Content |
|
|
266
|
+
|---|---|
|
|
267
|
+
| `kelviq://docs/{section}/{slug}` | Every conceptual page in the Kelviq docs (~59 pages) |
|
|
268
|
+
| `kelviq://openapi.json` | The full OpenAPI 3.0 spec (49 operations, every schema) |
|
|
269
|
+
| `kelviq://README` | Top-level Kelviq overview |
|
|
270
|
+
|
|
271
|
+
For exhaustive per-endpoint request/response shapes, the **OpenAPI spec is the source of truth**. Ask your assistant *"check the OpenAPI spec for createSubscription"* and it will read the resource directly.
|
|
272
|
+
|
|
273
|
+
---
|
|
274
|
+
|
|
275
|
+
## Example Prompts
|
|
276
|
+
|
|
277
|
+
The whole point of the MCP server is that you describe the outcome, not the API call. A few realistic prompts that exercise the toolchain:
|
|
278
|
+
|
|
279
|
+
|
|
280
|
+
|
|
281
|
+
> *Create a Kelviq product called "Notion Plus" with tax code `saas`, then create three plans (Free, Pro Monthly $19, Pro Yearly $190), add an `api-calls` feature with limits 1000 / 50000 / unlimited, and publish all three plans.*
|
|
282
|
+
|
|
283
|
+
Calls (in order): `product_create` → `feature_create` → `plan_create` × 3 → `plan_entitlements_add` × 3 → `plan_prices_bulk_set` × 3 → `plan_publish` × 3.
|
|
284
|
+
|
|
285
|
+
|
|
286
|
+
|
|
287
|
+
|
|
288
|
+
> *Create a checkout session for plan `pro-monthly` for a new customer, success URL https://example.com/done.*
|
|
289
|
+
|
|
290
|
+
Calls: `checkout_create_session`. Returns the `checkoutUrl` you can hand to your buyer.
|
|
291
|
+
|
|
292
|
+
|
|
293
|
+
|
|
294
|
+
|
|
295
|
+
> *Provision a Kelviq org for partner external ID `acme-99`, owner email `ops@acme.com`, business name "Acme Corp".*
|
|
296
|
+
|
|
297
|
+
Calls: `partner_org_provision`. Returns the new org's identifier + API keys.
|
|
298
|
+
|
|
299
|
+
|
|
300
|
+
|
|
301
|
+
|
|
302
|
+
> *Activate license `LIC-ABCDE` for customer `geojacob`, instance name "MacBook Pro M3", then validate it.*
|
|
303
|
+
|
|
304
|
+
Calls: `license_activate` → `license_validate`.
|
|
305
|
+
|
|
306
|
+
|
|
307
|
+
|
|
308
|
+
|
|
309
|
+
> *Show me all subscriptions for customer `acme-42` and tell me which features they have access to.*
|
|
310
|
+
|
|
311
|
+
Calls: `subscription_list` → `entitlements_get`.
|
|
312
|
+
|
|
313
|
+
|
|
314
|
+
|
|
315
|
+
|
|
316
|
+
> *How do digital downloads work in Kelviq? What's the file-size limit?*
|
|
317
|
+
|
|
318
|
+
Calls: `docs_search` → `docs_read`. No API key needed — works offline.
|
|
319
|
+
|
|
320
|
+
|
|
321
|
+
---
|
|
322
|
+
|
|
323
|
+
## Tips for Effective Prompts
|
|
324
|
+
|
|
325
|
+
|
|
326
|
+
|
|
327
|
+
LLMs typically have many MCP tools loaded. Saying "create a *Kelviq* customer" steers the model toward this server's tools instead of guessing.
|
|
328
|
+
|
|
329
|
+
|
|
330
|
+
|
|
331
|
+
|
|
332
|
+
When you're unsure of an identifier or behaviour, ask the LLM to *"search Kelviq docs"* first — it grounds the follow-up calls in real semantics.
|
|
333
|
+
|
|
334
|
+
|
|
335
|
+
|
|
336
|
+
|
|
337
|
+
Tools return `{"error": {"status", "message"}}` shapes for API errors. The LLM will read them and adjust automatically (e.g. "Invalid product identifier" → ask you for the right one).
|
|
338
|
+
|
|
339
|
+
|
|
340
|
+
|
|
341
|
+
|
|
342
|
+
The LLM is happy to chain calls. "Create the product, then publish all its plans" is one prompt, not five.
|
|
343
|
+
|
|
344
|
+
|
|
345
|
+
---
|
|
346
|
+
|
|
347
|
+
## Troubleshooting
|
|
348
|
+
|
|
349
|
+
### `Executable not found in $PATH: "node"` in Claude Code
|
|
350
|
+
|
|
351
|
+
GUI/launcher processes don't source `~/.zshrc`, so nvm's `node` isn't visible to them. Pick one:
|
|
352
|
+
|
|
353
|
+
|
|
354
|
+
|
|
355
|
+
```bash
|
|
356
|
+
sudo ln -s "$(which node)" /usr/local/bin/node
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
One-time fix for every MCP server you'll ever add.
|
|
360
|
+
|
|
361
|
+
|
|
362
|
+
|
|
363
|
+
|
|
364
|
+
```bash
|
|
365
|
+
claude mcp add kelviq \
|
|
366
|
+
--env KELVIQ_SERVER_API_KEY=... \
|
|
367
|
+
-- /Users/you/.nvm/versions/node/v20.19.0/bin/node \
|
|
368
|
+
$(npm root -g)/@kelviq/mcp-server/dist/server.js
|
|
369
|
+
```
|
|
370
|
+
|
|
371
|
+
|
|
372
|
+
|
|
373
|
+
|
|
374
|
+
```bash
|
|
375
|
+
brew install node
|
|
376
|
+
```
|
|
377
|
+
|
|
378
|
+
Puts `node` on the system PATH so all GUI tools see it.
|
|
379
|
+
|
|
380
|
+
|
|
381
|
+
### `error: unknown option '-y'` from `claude mcp add`
|
|
382
|
+
|
|
383
|
+
`claude` is intercepting `-y` as one of its own flags. Use `--` to separate Claude's args from the actual command:
|
|
384
|
+
|
|
385
|
+
```bash
|
|
386
|
+
claude mcp add kelviq \
|
|
387
|
+
--env KELVIQ_SERVER_API_KEY=... \
|
|
388
|
+
-- npx -y @kelviq/mcp-server
|
|
389
|
+
```
|
|
390
|
+
|
|
391
|
+
### Tool returns `{"error": {"status": "Configuration error", ...}}`
|
|
392
|
+
|
|
393
|
+
A required env var is missing. The error message names which one — set it in your client config and reconnect.
|
|
394
|
+
|
|
395
|
+
### Tool returns `{"error": {"status": "Bad request", "message": "Invalid product identifier"}}`
|
|
396
|
+
|
|
397
|
+
Your API key works but the identifier doesn't exist on this account. Most common cause: your key is for **production** but the identifier exists only in **staging** (or vice versa). Check `KELVIQ_BASE_URL`.
|
|
398
|
+
|
|
399
|
+
### Test without an AI client
|
|
400
|
+
|
|
401
|
+
Use the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector) to browse and call tools directly from a browser:
|
|
402
|
+
|
|
403
|
+
```bash
|
|
404
|
+
KELVIQ_SERVER_API_KEY=... KELVIQ_CLIENT_API_KEY=... \
|
|
405
|
+
npx -y @modelcontextprotocol/inspector \
|
|
406
|
+
npx -y @kelviq/mcp-server
|
|
407
|
+
```
|
|
408
|
+
|
|
409
|
+
---
|
|
410
|
+
|
|
411
|
+
## Source & Contributing
|
|
412
|
+
|
|
413
|
+
- **npm:** [`@kelviq/mcp-server`](https://www.npmjs.com/package/@kelviq/mcp-server)
|
|
414
|
+
- **GitHub:** [`kelviq/kelviq-mcp-server`](https://github.com/kelviq/kelviq-mcp-server)
|
|
415
|
+
- **Issues:** [github.com/kelviq/kelviq-mcp-server/issues](https://github.com/kelviq/kelviq-mcp-server/issues)
|
|
416
|
+
- **License:** MIT
|
|
417
|
+
|
|
418
|
+
The repo is the canonical reference for tool schemas, build process, and contribution guidelines. New Kelviq API endpoints are added by extending the hand-written zod schemas in `src/schemas/kelviq.ts` and the per-domain files in `src/tools/`.
|
package/dist/docs/manifest.json
CHANGED
|
@@ -153,6 +153,13 @@
|
|
|
153
153
|
"description": null,
|
|
154
154
|
"path": "getstarted/review-process.md"
|
|
155
155
|
},
|
|
156
|
+
{
|
|
157
|
+
"slug": "guides/mcp-server",
|
|
158
|
+
"section": "guides",
|
|
159
|
+
"title": "MCP Server",
|
|
160
|
+
"description": "Control Kelviq from Claude, Cursor, and any AI assistant that speaks the Model Context Protocol.",
|
|
161
|
+
"path": "guides/mcp-server.md"
|
|
162
|
+
},
|
|
156
163
|
{
|
|
157
164
|
"slug": "guides/subscription-integration",
|
|
158
165
|
"section": "guides",
|
package/dist/docs/openapi.json
CHANGED
|
@@ -3239,7 +3239,7 @@
|
|
|
3239
3239
|
"/entitlements/": {
|
|
3240
3240
|
"servers": [
|
|
3241
3241
|
{
|
|
3242
|
-
"url": "https://edge.api.kelviq.com",
|
|
3242
|
+
"url": "https://edge.api.kelviq.com/api/v1",
|
|
3243
3243
|
"description": "Edge API for Entitlements"
|
|
3244
3244
|
}
|
|
3245
3245
|
],
|
|
@@ -4292,7 +4292,7 @@
|
|
|
4292
4292
|
"operationId": "getPromotion",
|
|
4293
4293
|
"servers": [
|
|
4294
4294
|
{
|
|
4295
|
-
"url": "https://edge.kelviq.com/api/v1",
|
|
4295
|
+
"url": "https://edge.api.kelviq.com/api/v1",
|
|
4296
4296
|
"description": "Kelviq Edge API"
|
|
4297
4297
|
}
|
|
4298
4298
|
],
|
package/dist/http/client.d.ts
CHANGED
|
@@ -9,7 +9,7 @@ export type RequestInit = {
|
|
|
9
9
|
/** Query string params. Skipped when value is null/undefined. */
|
|
10
10
|
query?: Record<string, string | number | boolean | null | undefined>;
|
|
11
11
|
/** Which API host to call. Defaults to 'base'. */
|
|
12
|
-
host?: 'base' | 'edge'
|
|
12
|
+
host?: 'base' | 'edge';
|
|
13
13
|
/** Which API key to send. */
|
|
14
14
|
auth: AuthScope;
|
|
15
15
|
};
|
package/dist/http/client.js
CHANGED
|
@@ -16,11 +16,7 @@ export class KelviqHttpClient {
|
|
|
16
16
|
}
|
|
17
17
|
return { ok: false, ...fromException(err) };
|
|
18
18
|
}
|
|
19
|
-
const host = init.host === 'edge'
|
|
20
|
-
? this.config.edgeUrl
|
|
21
|
-
: init.host === 'entitlements'
|
|
22
|
-
? this.config.entitlementsUrl
|
|
23
|
-
: this.config.baseUrl;
|
|
19
|
+
const host = init.host === 'edge' ? this.config.edgeUrl : this.config.baseUrl;
|
|
24
20
|
const url = this.buildUrl(host, init.path, init.query);
|
|
25
21
|
let response;
|
|
26
22
|
try {
|
package/dist/http/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9F,OAAO,EAAuB,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAkBnF,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAErD,KAAK,CAAC,OAAO,CAAc,IAAiB;QAC1C,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;gBACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,IAAI,
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"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"}
|
package/dist/server.js
CHANGED
|
@@ -10,7 +10,7 @@ async function main() {
|
|
|
10
10
|
const http = new KelviqHttpClient(config);
|
|
11
11
|
const server = new McpServer({
|
|
12
12
|
name: 'kelviq',
|
|
13
|
-
version: '0.2.
|
|
13
|
+
version: '0.2.3',
|
|
14
14
|
}, {
|
|
15
15
|
capabilities: {
|
|
16
16
|
tools: {},
|
|
@@ -32,7 +32,7 @@ async function main() {
|
|
|
32
32
|
const transport = new StdioServerTransport();
|
|
33
33
|
await server.connect(transport);
|
|
34
34
|
// Diagnostics go to stderr — stdout is reserved for the JSON-RPC stream.
|
|
35
|
-
process.stderr.write(`kelviq-mcp ready (base=${config.baseUrl},
|
|
35
|
+
process.stderr.write(`kelviq-mcp ready (base=${config.baseUrl}, edge=${config.edgeUrl}, server-key=${config.serverApiKey ? 'set' : 'MISSING'}, client-key=${config.clientApiKey ? 'set' : 'unset'})\n`);
|
|
36
36
|
}
|
|
37
37
|
main().catch((err) => {
|
|
38
38
|
console.error('kelviq-mcp failed to start:', err);
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;SACd;QACD,YAAY,EAAE;YACZ,wFAAwF;YACxF,EAAE;YACF,kJAAkJ;YAClJ,EAAE;YACF,8EAA8E;YAC9E,iGAAiG;YACjG,EAAE;YACF,wHAAwH;SACzH,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0BAA0B,MAAM,CAAC,OAAO,
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;SACd;QACD,YAAY,EAAE;YACZ,wFAAwF;YACxF,EAAE;YACF,kJAAkJ;YAClJ,EAAE;YACF,8EAA8E;YAC9E,iGAAiG;YACjG,EAAE;YACF,wHAAwH;SACzH,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0BAA0B,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,OAAO,gBAAgB,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,gBAAgB,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,CAClL,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAEnB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"entitlements.js","sourceRoot":"","sources":["../../src/tools/entitlements.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,IAAsB;IAChF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,+QAA+Q;QACjR,WAAW,EAAE,eAAe,CAAC,KAAK;KACnC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,
|
|
1
|
+
{"version":3,"file":"entitlements.js","sourceRoot":"","sources":["../../src/tools/entitlements.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,IAAsB;IAChF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,+QAA+Q;QACjR,WAAW,EAAE,eAAe,CAAC,KAAK;KACnC,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE;gBACL,WAAW,EAAE,KAAK,CAAC,UAAU;gBAC7B,UAAU,EAAE,KAAK,CAAC,SAAS;aAC5B;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.2.
|
|
3
|
+
"version": "0.2.3",
|
|
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>",
|