@centrali-io/centrali-mcp 4.2.0 → 4.2.1

package/README.md

@@ -2,7 +2,7 @@
 
 MCP (Model Context Protocol) server for the Centrali platform. Lets AI assistants (Claude, Cursor, etc.) interact with Centrali workspaces — query data, manage records, search, trigger compute functions, and more.
 
-Built on `@centrali-io/centrali-sdk` v3.1.0. Authenticates via service account client credentials.
+Built on `@centrali-io/centrali-sdk` v4.2.0. Authenticates via service account client credentials.
 
 ## Setup
 
@@ -33,6 +33,7 @@ Add to your MCP client configuration (e.g., Claude Desktop, Cursor):
 | `CENTRALI_CLIENT_ID` | Yes | Service account client ID |
 | `CENTRALI_CLIENT_SECRET` | Yes | Service account client secret |
 | `CENTRALI_WORKSPACE` | Yes | Workspace slug to operate in |
+| `CENTRALI_PAGES_URL` | No | Override pages API URL (default: derived as `api.{domain}/pages`) |
 
 ## Available Tools
 
@@ -75,6 +76,29 @@ Add to your MCP client configuration (e.g., Claude Desktop, Cursor):
 | `list_smart_queries` | List smart queries, optionally filtered by structure |
 | `execute_smart_query` | Execute a smart query with optional variables |
 
+### Pages
+| Tool | Description |
+|------|-------------|
+| `list_pages` | List all pages in the workspace |
+| `get_page` | Get a page by ID |
+| `create_page` | Create a new page (list, detail, form, or dashboard) |
+| `update_page` | Update page metadata (name, slug, description) |
+| `delete_page` | Soft-delete a page |
+| `save_page_draft` | Save or update a page's draft definition |
+| `get_page_draft` | Get the current draft of a page |
+| `list_page_versions` | List all versions of a page |
+| `validate_page` | Validate a page draft before publishing |
+| `publish_page` | Publish a page to its runtime URL |
+| `unpublish_page` | Unpublish a page |
+| `set_page_access_policy` | Set access policy (public, authenticated, role-gated) |
+| `get_page_theme` | Get workspace page theme |
+| `set_page_theme` | Set workspace page theme (colors, logo, font) |
+| `get_navigation` | Get workspace navigation config |
+| `set_navigation` | Set workspace navigation config |
+| `delete_navigation` | Delete navigation config (revert to standalone pages) |
+| `generate_starter_pages` | Generate page proposals from structure IDs |
+| `accept_page_proposal` | Accept a generated proposal and create the page |
+
 ## Resources
 
 | URI | Description |

package/dist/index.js

@@ -21,6 +21,8 @@ const smart_queries_js_1 = require("./tools/smart-queries.js");
 const orchestrations_js_1 = require("./tools/orchestrations.js");
 const insights_js_1 = require("./tools/insights.js");
 const validation_js_1 = require("./tools/validation.js");
+const pages_js_1 = require("./tools/pages.js");
+const describe_js_1 = require("./tools/describe.js");
 const structures_js_2 = require("./resources/structures.js");
 function getRequiredEnv(name) {
     const value = process.env[name];
@@ -56,6 +58,8 @@ function main() {
         (0, orchestrations_js_1.registerOrchestrationTools)(server, sdk);
         (0, insights_js_1.registerInsightTools)(server, sdk);
         (0, validation_js_1.registerValidationTools)(server, sdk);
+        (0, pages_js_1.registerPageTools)(server, sdk, baseUrl, workspaceId);
+        (0, describe_js_1.registerDescribeTools)(server);
         // Register resources
         (0, structures_js_2.registerCollectionResources)(server, sdk);
         (0, structures_js_2.registerStructureResources)(server, sdk);

package/dist/tools/describe.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Introspection tools that teach AI assistants the valid shapes, schemas,
+ * and domain concepts for every Centrali API. These tools return static
+ * documentation — no network calls, no auth required.
+ *
+ * Pattern inspired by Supabase MCP (list_tables / get_schemas) and
+ * Stripe MCP (search_stripe_documentation).
+ */
+export declare function registerDescribeTools(server: McpServer): void;