@xano/developer-mcp 1.0.40 → 1.0.42

package/dist/xanoscript_docs/syntax.md

@@ -18,6 +18,10 @@ Complete reference for XanoScript expressions, operators, and filters.
 | [Math Filters](#math-filters) | `add`, `subtract`, `round`, `abs`, `ceil`, `floor` |
 | [String Filters](#string-filters) | `trim`, `to_lower`, `to_upper`, `substr`, `split`, `replace` |
 | [Array Filters](#array-filters) | `first`, `last`, `count`, `map`, `filter`, `reduce` |
+| [Array Functions](#array-functions) | `array.push`, `array.pop`, `array.map`, `array.filter`, `array.group_by` |
+| [Text Functions](#text-functions) | `text.contains`, `text.starts_with`, `text.trim`, `text.append`, `text.prepend` |
+| [Math Functions](#math-functions) | `math.add`, `math.sub`, `math.mul`, `math.div`, `math.bitwise.*` |
+| [Object Functions](#object-functions) | `object.keys`, `object.values`, `object.entries` |
 | [Object Filters](#object-filters) | `get`, `set`, `has`, `keys`, `values` |
 | [Type Filters](#type-filters) | `to_int`, `to_text`, `to_bool`, `json_encode` |
 | [Date/Time Filters](#datetime-filters) | `to_timestamp`, `format_timestamp` |
@@ -56,12 +60,13 @@ Working with...
 ├── Arrays? → USE ARRAY FILTERS ONLY (see Array Filters section)
 │   ├── Get element? → first, last, get
 │   ├── Count items? → count (NOT strlen)
-│   ├── Transform all? → map
-│   ├── Keep some? → filter
-│   ├── Find one? → find
+│   ├── Transform all? → map (filter) or array.map (statement)
+│   ├── Keep some? → filter (filter) or array.filter (statement)
+│   ├── Find one? → find (filter) or array.find (statement)
 │   ├── Combine? → reduce
 │   ├── Reverse? → reverse (NOT available on strings)
-│   └── Sort? → sort
+│   ├── Sort? → sort
+│   └── Statement-level ops? → See Array Functions (array.push, array.pop, etc.)
 ├── Objects?
 │   ├── Get value? → get
 │   ├── Set value? → set
@@ -335,6 +340,408 @@ Generate numeric ranges with the `..` operator:
 
 ---
 
+## Array Functions
+
+Statement-level functions for manipulating arrays within stacks. Unlike filters (e.g., `$arr|push:3`), these are standalone operations.
+
+> **Syntax note:** Functions that use a `{ by = ... }` or `{ value = ... }` block wrap the array in parentheses — e.g., `array.map ($arr) { ... }`. Functions that use an `if (...)` condition take a bare variable — e.g., `array.filter $arr if (...) as $result`.
+
+### array.push
+
+Appends a new element to the end of an array.
+
+```xs
+array.push $shopping_cart {
+  value = "oranges"
+}
+```
+
+### array.unshift
+
+Inserts a new element at the beginning of an array, shifting existing elements to higher indexes.
+
+```xs
+array.unshift $priority_tasks {
+  value = "urgent meeting"
+}
+```
+
+### array.pop
+
+Removes and returns the last element of an array. The removed element is stored in the `as` variable.
+
+```xs
+array.pop $completed_tasks as $last_finished_task
+```
+
+### array.shift
+
+Removes and returns the first element of an array. The removed element is stored in the `as` variable.
+
+```xs
+array.shift $waiting_list as $next_customer
+```
+
+### array.merge
+
+Combines another array or a single value into the target array, appending all elements from the provided `value`.
+
+```xs
+array.merge $active_users {
+  value = $new_users
+}
+```
+
+### array.find
+
+Searches an array and returns the first element that meets the specified condition. Returns `null` if no match.
+
+```xs
+array.find $customer_ages if ($this > 18) as $first_adult_age
+```
+
+### array.find_index
+
+Returns the index of the first element that satisfies the condition. Returns `-1` if no match.
+
+```xs
+array.find_index $sale_prices if ($this < 20) as $first_discount_index
+```
+
+### array.has
+
+Checks if at least one element meets the condition. Returns `true` or `false`.
+
+```xs
+array.has $team_roles if ($this == "manager") as $has_manager
+```
+
+### array.every
+
+Tests whether every element satisfies the condition. Returns `true` if all pass, `false` otherwise.
+
+```xs
+array.every $exam_scores if ($this >= 70) as $all_passed
+```
+
+### array.filter
+
+Creates a new array containing only the elements that meet the condition.
+
+```xs
+array.filter $temperatures if ($this > 32) as $above_freezing
+```
+
+### array.filter_count
+
+Counts how many elements satisfy the condition.
+
+```xs
+array.filter_count $survey_responses if ($this == "yes") as $yes_count
+```
+
+### array.map
+
+Transforms each element in an array based on a specified mapping. The `by` parameter defines the transformation.
+
+```xs
+array.map ($json) {
+  by = $this.email
+} as $emails
+
+array.map ($json) {
+  by = {name: $this.name, gender: $this.gender}
+} as $people
+```
+
+### array.partition
+
+Divides an array into two groups based on a condition. Returns an object with `true` and `false` keys.
+
+```xs
+array.partition ($json) if ($this.gender == "male") as $is_male
+```
+
+### array.group_by
+
+Groups elements based on a specified key or expression. Returns an object where each key is a group.
+
+```xs
+array.group_by ($users) {
+  by = $this.gender
+} as $user_by_gender
+```
+
+### array.union
+
+Combines two arrays ensuring all elements are unique based on the `by` key.
+
+```xs
+array.union ([1,3,5,7,9]) {
+  value = [2,4,6,8]
+  by = $this
+} as $union
+// Result: [1,2,3,4,5,6,7,8,9]
+```
+
+### array.difference
+
+Returns elements present in the first array but not in the second, based on the `by` key.
+
+```xs
+array.difference ([1,2,3,4,5,6,7,8,9]) {
+  value = [2,4,6,8]
+  by = $this
+} as $difference
+// Result: [1,3,5,7,9]
+```
+
+### array.intersection
+
+Returns elements present in both arrays, based on the `by` key.
+
+```xs
+array.intersection ([1,2,3,4,5,6,7,8,9]) {
+  value = [2,4,6,8]
+  by = $this
+} as $intersection
+// Result: [2,4,6,8]
+```
+
+---
+
+## Text Functions
+
+Statement-level functions for text manipulation within stacks. These operate directly on variables — checking conditions (returning `true`/`false` via `as`) or mutating the variable in place.
+
+> **Syntax note:** Functions that check a condition (e.g., `text.contains`, `text.starts_with`) store the result in an `as` variable. Functions that modify text (e.g., `text.trim`, `text.append`) mutate the variable directly and do not return a value.
+
+### text.contains
+
+Checks if a text string contains the specified value. Returns `true` if found, `false` otherwise.
+
+```xs
+text.contains $log_entry {
+  value = "error"
+} as $has_error
+```
+
+### text.icontains
+
+Performs a case-insensitive check to see if a text string contains the specified value.
+
+```xs
+text.icontains $description {
+  value = "error"
+} as $has_error
+```
+
+### text.starts_with
+
+Checks if a text string begins with the specified value.
+
+```xs
+text.starts_with $message {
+  value = "Hello"
+} as $starts_with_hello
+```
+
+### text.istarts_with
+
+Performs a case-insensitive check to see if a text string starts with the specified value.
+
+```xs
+text.istarts_with $title {
+  value = "intro"
+} as $starts_with_intro
+```
+
+### text.ends_with
+
+Checks if a text string ends with the specified value.
+
+```xs
+text.ends_with $url {
+  value = ".com"
+} as $is_com_domain
+```
+
+### text.iends_with
+
+Performs a case-insensitive check to see if a text string ends with the specified value.
+
+```xs
+text.iends_with $filename {
+  value = "pdf"
+} as $ends_with_pdf
+```
+
+### text.trim
+
+Removes characters (default is whitespace, or as specified by `value`) from both the beginning and end of a text string. Mutates the variable directly.
+
+```xs
+text.trim $user_input {
+  value = " "
+}
+```
+
+### text.ltrim
+
+Removes leading characters (default is whitespace, or as specified by `value`) from a text string. Mutates the variable directly.
+
+```xs
+text.ltrim $user_input {
+  value = " "
+}
+```
+
+### text.rtrim
+
+Removes trailing characters (default is whitespace, or as specified by `value`) from a text string. Mutates the variable directly.
+
+```xs
+text.rtrim $user_input {
+  value = " "
+}
+```
+
+### text.append
+
+Adds the specified value to the end of a text string. Mutates the variable directly.
+
+```xs
+text.append $greeting {
+  value = ", welcome!"
+}
+```
+
+### text.prepend
+
+Adds the specified value to the beginning of a text string. Mutates the variable directly.
+
+```xs
+text.prepend $message {
+  value = "Alert: "
+}
+```
+
+---
+
+## Math Functions
+
+Statement-level functions for arithmetic and bitwise operations within stacks. These mutate the target variable directly and do not return a value.
+
+> **Note:** These are different from math filters (e.g., `$x|add:5`) and math domain functions (e.g., `math.add(5, 3)`). Statement-level math functions modify the variable in place.
+
+### math.add
+
+Adds the specified value to the variable.
+
+```xs
+math.add $cart_total {
+  value = $item_price
+}
+```
+
+### math.sub
+
+Subtracts the specified value from the variable.
+
+```xs
+math.sub $total_cost {
+  value = $discount_amount
+}
+```
+
+### math.mul
+
+Multiplies the variable by the specified value.
+
+```xs
+math.mul $base_price {
+  value = $tax_rate
+}
+```
+
+### math.div
+
+Divides the variable by the specified value.
+
+```xs
+math.div $total_time {
+  value = $num_tasks
+}
+```
+
+### math.bitwise.and
+
+Performs a bitwise AND operation on the variable.
+
+```xs
+math.bitwise.and $status_flags {
+  value = $check_bit
+}
+```
+
+### math.bitwise.or
+
+Performs a bitwise OR operation on the variable.
+
+```xs
+math.bitwise.or $permissions {
+  value = $new_permission
+}
+```
+
+### math.bitwise.xor
+
+Performs a bitwise XOR operation on the variable.
+
+```xs
+math.bitwise.xor $flags {
+  value = $toggle_bit
+}
+```
+
+---
+
+## Object Functions
+
+Statement-level functions for extracting object properties within stacks. These return results via the `as` variable.
+
+### object.keys
+
+Retrieves the property keys of an object as an array.
+
+```xs
+object.keys {
+  value = $user_data
+} as $user_data_keys
+```
+
+### object.values
+
+Extracts the values of an object's properties into an array.
+
+```xs
+object.values {
+  value = $product_info
+} as $product_values
+```
+
+### object.entries
+
+Returns an array of key-value pairs from an object.
+
+```xs
+object.entries {
+  value = $settings
+} as $settings_pairs
+```
+
+---
+
 ## Object Filters
 
 | Filter | Example | Result |

package/dist/xanoscript_docs/version.json

@@ -1,4 +1,4 @@
 {
-  "version": "2.0.0",
-  "updated": "2025-02-06"
+  "version": "2.1.0",
+  "updated": "2026-02-19"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/developer-mcp",
-  "version": "1.0.40",
+  "version": "1.0.42",
   "description": "MCP server and library for Xano development - XanoScript validation, Meta API, Run API, and CLI documentation",
   "type": "module",
   "main": "dist/lib.js",

package/dist/run_api_docs/format.d.ts

@@ -1,6 +0,0 @@
-/**
- * Formatting utilities for Run API documentation output
- * Re-exports the shared formatter with Run API configuration
- */
-import type { TopicDoc, DetailLevel } from "../meta_api_docs/types.js";
-export declare function formatDocumentation(doc: TopicDoc, detailLevel?: DetailLevel, includeSchemas?: boolean): string;

package/dist/run_api_docs/format.js

@@ -1,8 +0,0 @@
-/**
- * Formatting utilities for Run API documentation output
- * Re-exports the shared formatter with Run API configuration
- */
-import { formatDocumentation as formatDoc, RUN_API_CONFIG, } from "../meta_api_docs/format.js";
-export function formatDocumentation(doc, detailLevel = "detailed", includeSchemas = true) {
-    return formatDoc(doc, detailLevel, includeSchemas, RUN_API_CONFIG);
-}

package/dist/run_api_docs/format.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/run_api_docs/format.test.js

@@ -1,86 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { formatDocumentation } from "./format.js";
-describe("run_api_docs/format", () => {
-    describe("formatDocumentation", () => {
-        const minimalDoc = {
-            topic: "test",
-            title: "Test Topic",
-            description: "A test topic description",
-        };
-        it("should use Run API config by default", () => {
-            const docWithEndpoints = {
-                ...minimalDoc,
-                endpoints: [
-                    {
-                        method: "GET",
-                        path: "/test",
-                        description: "Test endpoint",
-                    },
-                ],
-            };
-            const result = formatDocumentation(docWithEndpoints);
-            expect(result).toContain("https://app.dev.xano.com/api:run/");
-            expect(result).toContain("NOT your Xano instance URL");
-        });
-        it("should format documentation with title", () => {
-            const result = formatDocumentation(minimalDoc);
-            expect(result).toContain("# Test Topic");
-        });
-        it("should format documentation with description", () => {
-            const result = formatDocumentation(minimalDoc);
-            expect(result).toContain("A test topic description");
-        });
-        it("should respect detail level", () => {
-            const docWithExamples = {
-                ...minimalDoc,
-                examples: [
-                    {
-                        title: "Example",
-                        description: "Test",
-                        request: { method: "GET", path: "/test" },
-                    },
-                ],
-            };
-            const overviewResult = formatDocumentation(docWithExamples, "overview");
-            expect(overviewResult).not.toContain("## Examples");
-            const detailedResult = formatDocumentation(docWithExamples, "detailed");
-            expect(detailedResult).toContain("## Examples");
-        });
-        it("should use run_api_docs in related topics", () => {
-            const docWithRelated = {
-                ...minimalDoc,
-                related_topics: ["session", "history"],
-            };
-            const result = formatDocumentation(docWithRelated);
-            expect(result).toContain("run_api_docs");
-            expect(result).toContain("session, history");
-        });
-        it("should default to detailed level", () => {
-            const docWithEndpoints = {
-                ...minimalDoc,
-                endpoints: [
-                    {
-                        method: "GET",
-                        path: "/test",
-                        description: "Test",
-                        parameters: [
-                            { name: "id", type: "string", description: "ID" },
-                        ],
-                    },
-                ],
-            };
-            const result = formatDocumentation(docWithEndpoints);
-            expect(result).toContain("**Parameters:**");
-        });
-        it("should default to including schemas", () => {
-            const docWithSchemas = {
-                ...minimalDoc,
-                schemas: {
-                    TestSchema: { type: "object" },
-                },
-            };
-            const result = formatDocumentation(docWithSchemas);
-            expect(result).toContain("## Schemas");
-        });
-    });
-});

package/dist/run_api_docs/index.d.ts

@@ -1,52 +0,0 @@
-/**
- * Xano Run API Documentation Index
- *
- * This module exports all documentation topics and provides
- * the run_api_docs tool handler for the MCP server.
- */
-import type { TopicDoc } from "../meta_api_docs/types.js";
-/**
- * All available documentation topics
- */
-export declare const topics: Record<string, TopicDoc>;
-/**
- * Get list of all available topic names
- */
-export declare function getTopicNames(): string[];
-/**
- * Get topic descriptions for tool documentation
- */
-export declare function getTopicDescriptions(): string;
-/**
- * Handler for the run_api_docs tool
- */
-export declare function handleRunApiDocs(topic?: string, detailLevel?: string, includeSchemas?: boolean): string;
-/**
- * Tool definition for MCP server
- */
-export declare const runApiDocsToolDefinition: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            topic: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            detail_level: {
-                type: string;
-                enum: string[];
-                default: string;
-                description: string;
-            };
-            include_schemas: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};

package/dist/run_api_docs/index.js

@@ -1,90 +0,0 @@
-/**
- * Xano Run API Documentation Index
- *
- * This module exports all documentation topics and provides
- * the run_api_docs tool handler for the MCP server.
- */
-import { formatDocumentation } from "./format.js";
-// Import all topic documentation
-import { startDoc } from "./topics/start.js";
-import { runDoc } from "./topics/run.js";
-import { sessionDoc } from "./topics/session.js";
-import { historyDoc } from "./topics/history.js";
-import { dataDoc } from "./topics/data.js";
-import { workflowsDoc } from "./topics/workflows.js";
-/**
- * All available documentation topics
- */
-export const topics = {
-    start: startDoc,
-    run: runDoc,
-    session: sessionDoc,
-    history: historyDoc,
-    data: dataDoc,
-    workflows: workflowsDoc,
-};
-/**
- * Get list of all available topic names
- */
-export function getTopicNames() {
-    return Object.keys(topics);
-}
-/**
- * Get topic descriptions for tool documentation
- */
-export function getTopicDescriptions() {
-    return Object.entries(topics)
-        .map(([key, doc]) => `- ${key}: ${doc.title}`)
-        .join("\n");
-}
-/**
- * Handler for the run_api_docs tool
- */
-export function handleRunApiDocs(topic, detailLevel, includeSchemas) {
-    // Validate topic
-    if (!topic || !topics[topic]) {
-        const available = getTopicNames().join(", ");
-        return `Error: Unknown topic "${topic}".\n\nAvailable topics: ${available}`;
-    }
-    const doc = topics[topic];
-    return formatDocumentation(doc, detailLevel || "detailed", includeSchemas !== false);
-}
-/**
- * Tool definition for MCP server
- */
-export const runApiDocsToolDefinition = {
-    name: "run_api_docs",
-    description: `Get documentation for Xano's Run API. Use this to understand runtime execution, session management, and XanoScript execution.
-
-**Important:** The Run API uses a fixed base URL: https://app.dev.xano.com/api:run/<endpoint> (NOT your Xano instance URL)
-
-## Topics
-${getTopicDescriptions()}
-
-## Usage
-- Start with "start" topic for overview and getting started
-- Use "workflows" for step-by-step guides
-- Use specific topics (run, session, etc.) for detailed endpoint docs`,
-    inputSchema: {
-        type: "object",
-        properties: {
-            topic: {
-                type: "string",
-                enum: getTopicNames(),
-                description: "Documentation topic to retrieve",
-            },
-            detail_level: {
-                type: "string",
-                enum: ["overview", "detailed", "examples"],
-                default: "detailed",
-                description: "Level of detail: overview (brief), detailed (full docs), examples (with code examples)",
-            },
-            include_schemas: {
-                type: "boolean",
-                default: true,
-                description: "Include JSON schemas for requests/responses",
-            },
-        },
-        required: ["topic"],
-    },
-};

package/dist/run_api_docs/index.test.d.ts

@@ -1 +0,0 @@
-export {};