@svgrid/mcp 3.0.17 → 3.0.18

package/README.md

@@ -22,19 +22,20 @@
 
 Point any MCP-capable client - Claude Desktop, Claude Code, Cursor, Zed - at this server and the model answers with **accurate, version-pinned** facts about SvGrid: real prop, method, and event names, plus every demo's source as grounding. No hallucinated APIs, no stale blog posts.
 
-**Why this beats pasting docs into the chat.** A model working from memory invents plausible SvGrid APIs, because it learned from a mix of other grids and older versions. Pasting docs helps for one question and then falls out of the context window. This server puts the current API surface and 370+ working demo sources one tool call away, for every question, pinned to the version you installed.
+**Why this beats pasting docs into the chat.** A model working from memory invents plausible SvGrid APIs, because it learned from a mix of other grids and older versions. Pasting docs helps for one question and then falls out of the context window. This server puts the current API surface and every working demo source one tool call away, for every question, pinned to the version you installed.
 
 ## Tools exposed
 
-Four. `tools/list` is sent on **every** request, so the tool surface is pure
+Five. `tools/list` is sent on **every** request, so the tool surface is pure
 overhead on every turn - this server used to spend ~4,710 tokens of it on 36
 tools, 79% of them Studio tools most sessions never call once.
 
 | Tool | Purpose |
 | --- | --- |
-| `svgrid_search` | Search the docs, all 400+ demos and the API surface **in one call**. No arguments returns an index. |
+| `svgrid_search` | Search the docs, every demo and the API surface **in one call**. No arguments returns an index. |
 | `svgrid_get` | Read one thing in full: a doc slug, a demo id, or `api`. |
 | `svgrid_check_code` | **Verify** a file against the real API surface + the Svelte compiler. |
+| `svgrid_preview` | Render a live, interactive grid in the conversation from columns + rows (MCP Apps). |
 | `svgrid_scaffold` | Studio: turn a Drizzle schema, sample rows or an `EntitySchema` into runnable SvelteKit files. |
 
 The docs and demos are also served as **MCP resources**
@@ -89,8 +90,8 @@ What it checks:
   too. The result says which of the two ran in its `compiler` field, so
   "no errors" is never mistaken for "this compiles".
 
-It is tuned to shut up when the code is right: it reports **nothing** across all
-400+ demos in this repo, which is what a CI test asserts. A verifier that cries
+It is tuned to shut up when the code is right: it reports **nothing** across
+every demo in this repo, which is what a CI test asserts. A verifier that cries
 wolf is worse than none, because a model will happily "fix" working code.
 
 ### Studio: drive the app model (agent co-designer)
@@ -122,8 +123,8 @@ failure reports which op failed and what already applied.
 | --- | --- | --- |
 | Install | `npx @svgrid/mcp` | `https://mcp.svgrid.com/mcp` |
 | Needs Node | yes | no |
-| `check_svgrid_code` compiles | yes | static checks only |
-| Studio `studio_*` tools | yes (27) | no |
+| `svgrid_check_code` compiles | yes | static checks only |
+| Studio `studio_*` tools | yes (opt-in) | no |
 | Works offline | yes | no |
 
 ```bash
@@ -136,8 +137,8 @@ claude mcp add --transport http svgrid https://mcp.svgrid.com/mcp
   <a href="https://insiders.vscode.dev/redirect/mcp/install?name=svgrid&config=%7B%22name%22%3A%22svgrid%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.svgrid.com%2Fmcp%22%7D"><img src="https://img.shields.io/badge/Add%20to-VS%20Code-0098FF?logo=visualstudiocode&logoColor=white" alt="Add to VS Code" /></a>
 </p>
 
-The remote server is live at **https://mcp.svgrid.com/mcp** and carries the six
-docs + verification tools ([source](../../workers/svgrid-mcp)). Use stdio when
+The remote server is live at **https://mcp.svgrid.com/mcp** and carries the docs,
+verification and preview tools ([source](../../workers/svgrid-mcp)). Use stdio when
 you want the compiler pass, the Studio tools, or no third-party endpoint in the
 loop.
 
@@ -206,6 +207,17 @@ node dist/index.js
 `examples/src/demos/*.svelte` and `docs/**/*.md` from the workspace and inlines
 them into `src/data.ts`, so the published package is fully self-contained.
 
+## Enterprise features
+
+Export to Excel and PDF, pivot tables, the Kanban board, the scheduler, the
+spreadsheet and the server-side row model live in `@svgrid/enterprise`, which
+is commercial. Answers say so: a paid doc or demo in `svgrid_search` results
+carries `"enterprise": true`, a question about a paid feature gets one line
+with the trial link, and `svgrid_check_code` adds it when the fix is to install
+the package. The package runs without a license key and shows a watermark
+until one is set. The [30-day trial](https://svgrid.com/pricing/?trial=mcp-docs)
+adds a download of every demo and 30 days of email support.
+
 ## Licensing
 
 MIT - free to run, no license key. Some tools generate SvGrid Studio projects, and Studio itself is

package/dist/core-tools.js

@@ -15,7 +15,8 @@
  */
 import { apiReference, apiSurface, docs, examples, schemas } from './data.js';
 import { meaningfulTerms, rankDocs } from './search.js';
-const DOCS_FOOTER = '\n\nSvGrid reference: full docs & 375 live demos at https://svgrid.com/docs';
+import { ENTERPRISE_LINE, ENTERPRISE_NOTE, importsEnterprise, isEnterpriseDoc, isPaidQuestion } from './enterprise.js';
+const DOCS_FOOTER = `\n\nSvGrid reference: full docs & ${examples.length} live demos at https://svgrid.com/docs`;
 const text = (body) => ({ content: [{ type: 'text', text: body }] });
 const withDocs = (body) => text(body + DOCS_FOOTER);
 const fail = (message) => ({
@@ -59,8 +60,20 @@ const apiNames = (() => {
         add(c.name, 'column option');
     for (const m of apiSurface.apiMethods)
         add(m, 'grid api method');
-    return [...merged].map(([name, groups]) => ({ name, group: [...groups].join(', ') }));
+    // The methods installEnterprise(api) adds are searchable too, so "export"
+    // finds exportData and says where it comes from. Not every enterprise
+    // export: over a thousand names drowned the free API on ordinary queries
+    // (tools/mcp-tools.test.ts, "filler words"); the docs and demos cover them.
+    for (const m of apiSurface.enterpriseApiMethods)
+        add(m, 'enterprise api method (installEnterprise)');
+    return [...merged].map(([name, groups]) => {
+        const group = [...groups].join(', ');
+        return { name, group, ...(group.includes('enterprise') ? { enterprise: true } : {}) };
+    });
 })();
+/** Docs and demos that use the paid package, found once from their source. */
+const enterpriseDocs = new Set(docs.filter((d) => isEnterpriseDoc(d.slug, d.markdown)).map((d) => d.slug));
+const enterpriseExamples = new Set(examples.filter((e) => importsEnterprise(e.source)).map((e) => e.id));
 export const CORE_TOOLS = [
     {
         name: 'svgrid_search',
@@ -240,7 +253,10 @@ function search(args) {
         body.docs = {
             total: ranked.total,
             partial: partial || undefined,
-            hits: shown.map((h) => detail === 'full' ? h : { ...h, excerpt: trimBlurb(String(h.excerpt ?? ''), 200) }),
+            hits: shown.map((h) => {
+                const hit = detail === 'full' ? h : { ...h, excerpt: trimBlurb(String(h.excerpt ?? ''), 200) };
+                return enterpriseDocs.has(String(h.slug)) ? { ...hit, enterprise: true } : hit;
+            }),
         };
         if (partial) {
             body.hint = `No page matched all of "${query}". These matched some of it - treat them as leads, not answers.`;
@@ -258,6 +274,7 @@ function search(args) {
                 title: e.title,
                 category: e.category,
                 blurb: detail === 'full' ? e.blurb : trimBlurb(e.blurb),
+                ...(enterpriseExamples.has(e.id) ? { enterprise: true } : {}),
             })),
         };
     }
@@ -268,6 +285,10 @@ function search(args) {
     const empty = !body.docs?.total &&
         !body.examples?.total &&
         !body.api?.total;
+    // Once per answer, and only when the question is about a paid feature.
+    const lists = [body.docs, body.examples, body.api].map((c) => c?.hits ?? []);
+    if (isPaidQuestion(lists))
+        body.enterprise = ENTERPRISE_NOTE;
     if (!empty) {
         // A partial-match warning outranks the generic next-step hint: it is the
         // one thing the caller must not miss, and it is set above.
@@ -352,15 +373,19 @@ function get(args) {
     }
     if (kind === 'doc' || kind === 'auto') {
         const doc = docs.find((d) => d.slug === ref);
-        if (doc)
-            return withDocs(clip(doc.markdown));
+        if (doc) {
+            // On top, where truncation cannot cut it off.
+            const paid = enterpriseDocs.has(doc.slug) ? `> ${ENTERPRISE_LINE}\n\n` : '';
+            return withDocs(clip(paid + doc.markdown));
+        }
         if (kind === 'doc') {
             return fail(`No doc with slug "${ref}". Use svgrid_search to find one.`);
         }
     }
     const example = examples.find((e) => e.id === ref);
     if (example) {
-        return text(clip(`// ${example.path}\n// ${example.title} - ${example.blurb}\n\n${example.source}`));
+        const paid = enterpriseExamples.has(example.id) ? `// ${ENTERPRISE_LINE}\n` : '';
+        return text(clip(`// ${example.path}\n// ${example.title} - ${example.blurb}\n${paid}\n${example.source}`));
     }
     // A miss is a chance to point somewhere useful rather than just say no.
     const near = [