@kelviq/mcp-server 0.2.1 → 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 CHANGED
@@ -82,16 +82,14 @@ key). Docs tools (`docs_search`, `docs_read`) work with no keys at all.
82
82
  | Variable | Required | Default | Purpose |
83
83
  |---|---|---|---|
84
84
  | `KELVIQ_SERVER_API_KEY` | yes (for API tools) | — | Bearer token for `api.kelviq.com` |
85
- | `KELVIQ_CLIENT_API_KEY` | only for `promotion_get` | — | Bearer token for `edge.kelviq.com` |
85
+ | `KELVIQ_CLIENT_API_KEY` | only for `promotion_get` | — | Bearer token for the edge host |
86
86
  | `KELVIQ_BASE_URL` | no | `https://api.kelviq.com/api/v1` | Override (sandbox, self-host) |
87
- | `KELVIQ_ENTITLEMENTS_URL` | no | `https://edge.api.kelviq.com` | Override entitlements host |
88
- | `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) |
89
88
 
90
89
  To point at Kelviq staging:
91
90
 
92
91
  ```
93
92
  KELVIQ_BASE_URL=https://stagingapi.kelviq.com/api/v1
94
- KELVIQ_ENTITLEMENTS_URL=https://edge.stagingapi.kelviq.com
95
93
  KELVIQ_EDGE_URL=https://edge.stagingapi.kelviq.com/api/v1
96
94
  ```
97
95
 
package/dist/config.d.ts CHANGED
@@ -4,7 +4,6 @@ export interface KelviqConfig {
4
4
  clientApiKey: string | undefined;
5
5
  baseUrl: string;
6
6
  edgeUrl: string;
7
- entitlementsUrl: string;
8
7
  userAgent: string;
9
8
  }
10
9
  export declare function loadConfig(env?: NodeJS.ProcessEnv): KelviqConfig;
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(env.KELVIQ_EDGE_URL?.trim() || DEFAULT_EDGE_URL),
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
  }
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AACzD,MAAM,gBAAgB,GAAG,gCAAgC,CAAC;AAC1D,MAAM,wBAAwB,GAAG,6BAA6B,CAAC;AAE/D,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,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,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,IAAI,gBAAgB,CAAC;QACpE,eAAe,EAAE,UAAU,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE,IAAI,wBAAwB,CAAC;QAC5F,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"}
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/`.
@@ -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",
@@ -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
  ],
@@ -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' | 'entitlements';
12
+ host?: 'base' | 'edge';
13
13
  /** Which API key to send. */
14
14
  auth: AuthScope;
15
15
  };
@@ -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 {
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"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"}
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.1',
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}, entitlements=${config.entitlementsUrl}, edge=${config.edgeUrl}, server-key=${config.serverApiKey ? 'set' : 'MISSING'}, client-key=${config.clientApiKey ? 'set' : 'unset'})\n`);
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);
@@ -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,kBAAkB,MAAM,CAAC,eAAe,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,CAC1N,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
+ {"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"}
@@ -9,7 +9,7 @@ export function registerEntitlementTools(server, http) {
9
9
  const result = await http.request({
10
10
  method: 'GET',
11
11
  path: '/entitlements/',
12
- host: 'entitlements',
12
+ host: 'edge',
13
13
  auth: 'server',
14
14
  query: {
15
15
  customer_id: input.customerId,
@@ -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,cAAc;YACpB,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"}
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.1",
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>",