@xano/developer-mcp 1.0.35 → 1.0.36

package/dist/xanoscript_docs/mcp-servers.md

@@ -185,3 +185,13 @@ The MCP protocol handles:
 2. **Comprehensive instructions** - Guide AI on server's overall purpose
 3. **Logical tool grouping** - Group related tools in one server
 4. **Keep focused** - One domain per server (support, analytics, etc.)
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `tools` | AI tool definitions used by MCP servers |
+| `agents` | AI agent configuration |
+| `triggers` | MCP server triggers for connection events |

package/dist/xanoscript_docs/performance.md

@@ -6,6 +6,10 @@ applyTo: "function/**/*.xs, api/**/*.xs"
 
 Best practices for building fast, efficient XanoScript applications.
 
+> **TL;DR:** Index frequently queried fields. Use `select` to fetch only needed columns. Use `db.add_bulk`/`db.edit_bulk` for batch operations. Cache with Redis. Paginate large result sets.
+
+---
+
 ## Quick Reference
 
 | Area | Key Techniques |
@@ -387,3 +391,14 @@ conditional {
 8. **Filter early** - In database, not application code
 9. **Stream large responses** - Don't load into memory
 10. **Monitor performance** - Log slow operations
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `database` | Query optimization |
+| `integrations/redis` | Caching patterns |
+| `streaming` | Large data handling |
+| `debugging` | Performance monitoring |

package/dist/xanoscript_docs/quickstart.md

@@ -6,6 +6,8 @@ applyTo: "**/*.xs"
 
 Essential patterns for XanoScript development. Use this as a quick reference for frequently-used code patterns.
 
+> **TL;DR:** Quick reference for common patterns. Key rules: use `text` not `string`, `elseif` not `else if`, `params` not `body` for api.request, parentheses around filters in expressions.
+
 ## Quick Reference
 
 ### Reserved Variable Names
@@ -180,67 +182,21 @@ input {
 
 ### Quick Filter Reference
 
-> **Full reference:** For the complete list of filters with examples, see `xanoscript_docs({ topic: "syntax" })`.
-
-**String Filters:**
-```xs
-$s|trim                    // Remove whitespace
-$s|to_lower                // Lowercase
-$s|to_upper                // Uppercase
-$s|substr:1:3              // Substring from index 1, length 3
-$s|split:","               // Split by delimiter → array
-$s|replace:"old":"new"     // Replace text
-$s|contains:"text"         // Check if contains → bool
-$s|strlen                  // String length
-```
+The most common filters at a glance:
 
-**Array Filters:**
-```xs
-$arr|first                 // First element
-$arr|last                  // Last element
-$arr|count                 // Array length
-$arr|push:$item            // Add to end
-$arr|pop                   // Remove & return last
-$arr|join:","              // Join to string
-$arr|map:$$.name           // Transform elements
-$arr|filter:$$.active      // Filter elements
-$arr|find:$$.id == 5       // Find first match
-```
+| Filter | Example | Result |
+|--------|---------|--------|
+| `trim` | `" hello "|trim` | `"hello"` |
+| `lower` | `"HELLO"|lower` | `"hello"` |
+| `first` | `[1,2,3]|first` | `1` |
+| `count` | `[1,2,3]|count` | `3` |
+| `to_int` | `"42"|to_int` | `42` |
+| `json_encode` | `{a:1}|json_encode` | `"{\"a\":1}"` |
+| `get` | `$obj|get:"key":"default"` | value or default |
 
-**Object Filters:**
-```xs
-$obj|get:"key"             // Get property value
-$obj|get:"key":"default"   // With default if missing
-$obj|set:"key":"value"     // Set property
-$obj|has:"key"             // Check if key exists → bool
-$obj|keys                  // Get all keys → array
-$obj|values                // Get all values → array
-```
+**Null handling:** `$val ?? "default"` or `$val|first_notnull:"default"`
 
-**Type Conversion:**
-```xs
-$val|to_text               // Convert to string
-$val|to_int                // Convert to integer
-$val|to_decimal            // Convert to decimal
-$val|to_bool               // Convert to boolean
-$val|json_encode           // Object → JSON string
-$str|json_decode           // JSON string → object
-```
-
-**Null Handling:**
-```xs
-$val|first_notnull:"default"   // Default if null
-$val|first_notempty:"default"  // Default if empty
-$val ?? "default"               // Nullish coalescing (same as first_notnull)
-```
-
-**Encoding:**
-```xs
-$s|url_encode              // URL encode
-$s|url_decode              // URL decode
-$s|base64_encode           // Base64 encode
-$s|base64_decode           // Base64 decode
-```
+> **Full reference:** See `xanoscript_docs({ topic: "syntax" })` for all 100+ filters organized by category (string, array, object, type, date, encoding).
 
 ---
 
@@ -264,37 +220,15 @@ precondition ($input.email|contains:"@") {
 
 ### 2. Database CRUD
 
-> **Full reference:** For all db.* operations including transactions, see `xanoscript_docs({ topic: "database" })`.
+| Operation | Use Case | Example |
+|-----------|----------|---------|
+| `db.get` | Single record by ID | `db.get "users" { field_name = "id" field_value = 1 } as $user` |
+| `db.query` | Filtered list | `db.query "users" { where = $db.users.active == true } as $users` |
+| `db.add` | Insert | `db.add "users" { data = { name: "John" } } as $new` |
+| `db.edit` | Update | `db.edit "users" { field_name = "id" field_value = 1 data = { name: "Jane" } }` |
+| `db.delete` | Delete | `db.delete "users" { field_name = "id" field_value = 1 }` |
 
-```xs
-// Create
-db.add "user" {
-  data = { name: $input.name, email: $input.email }
-} as $new_user
-
-// Read one
-db.get "user" {
-  where = $db.user.id == $input.id
-} as $user
-
-// Read many
-db.query "user" {
-  where = $db.user.is_active == true
-  order = [{ field: created_at, direction: desc }]
-  paging = { limit: 10, offset: 0 }
-} as $users
-
-// Update
-db.edit "user" {
-  where = $db.user.id == $input.id
-  data = { name: $input.name }
-}
-
-// Delete
-db.delete "user" {
-  where = $db.user.id == $input.id
-}
-```
+> **Full reference:** See `xanoscript_docs({ topic: "database" })` for joins, bulk operations, transactions, and more.
 
 ### 3. Optional Field Handling
 

package/dist/xanoscript_docs/run.md

@@ -366,3 +366,13 @@ query list verb=GET {
 3. **Keep self-contained** - Include all required tables and functions
 4. **Seed test data** - Use `items` in table definitions for testing
 5. **Validate inputs** - Use preconditions in functions for input validation
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `functions` | Function stacks run by jobs |
+| `tasks` | Scheduled task definitions |
+| `tables` | Database tables accessed by jobs |

package/dist/xanoscript_docs/security.md

@@ -6,6 +6,21 @@ applyTo: "function/**/*.xs, api/**/*.xs"
 
 Best practices for building secure XanoScript applications.
 
+> **TL;DR:** Always check `$auth.id` for protected endpoints. Use `security.create_auth_token` for JWT. Validate all inputs with `filters=`. Hash passwords with `password` type. Use `$env.SECRET_NAME` for secrets.
+
+## Section Index
+
+- [Authentication](#authentication) (L24) - Tokens, sessions, MFA
+- [Authorization](#authorization) (L186) - Role checks, ownership
+- [Input Validation](#input-validation) (L277) - Type enforcement, sanitization
+- [Data Protection](#data-protection) (L339) - Encryption, hashing, secrets
+- [Rate Limiting](#rate-limiting--abuse-prevention) (L427) - API limits, abuse prevention
+- [Security Headers](#security-headers) (L486) - CORS configuration
+- [Audit Logging](#audit-logging) (L504) - Security event tracking
+- [Best Practices Summary](#best-practices-summary) (L545) - Quick checklist
+
+---
+
 ## Quick Reference
 
 | Area | Key Practices |
@@ -550,3 +565,14 @@ function.run "audit_log" {
 8. **Log security events** - Audit trail for compliance
 9. **Use HTTPS** - Always (handled by platform)
 10. **Rotate tokens** - Implement refresh token flow
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `apis` | Endpoint authentication |
+| `types` | Input validation |
+| `middleware` | Request interceptors |
+| `integrations/redis` | Rate limiting |

package/dist/xanoscript_docs/streaming.md

@@ -338,3 +338,13 @@ query "stream_large_dataset" {
 3. **Handle errors gracefully** - Log failures without stopping stream
 4. **Set appropriate chunk sizes** - Balance memory and performance
 5. **Use JSONL for structured data** - Easier to parse than multi-line JSON
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `integrations` | Cloud storage for file sources |
+| `apis` | Streaming API responses |
+| `database` | Processing streamed data into tables |

package/dist/xanoscript_docs/syntax.md

@@ -6,6 +6,62 @@ applyTo: "**/*.xs"
 
 Complete reference for XanoScript expressions, operators, and filters.
 
+> **TL;DR:** XanoScript uses `|` for filters (`$text|trim`), `~` for string concat, and standard operators (`==`, `!=`, `&&`, `||`). Filters are chainable. Error handling uses `precondition`, `try_catch`, and `throw`.
+
+## Section Index
+
+| Section | Contents |
+|---------|----------|
+| [Operators](#quick-reference) | Comparison, logical, math, null-safe |
+| [Conditional Blocks](#conditional-blocks) | `conditional`, `if`/`elseif`/`else` |
+| [Expressions](#expressions) | Backtick syntax, comparisons |
+| [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` |
+| [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` |
+| [Encoding Filters](#encoding-filters) | `url_encode`, `base64_encode`, `json_encode` |
+| [Security Filters](#security-filters) | `md5`, `sha256`, `encrypt`, `jws_encode` |
+| [DB Query Filters](#db-query-filters) | `contains`, `includes`, `between`, `within` |
+| [Error Handling](#error-handling) | `precondition`, `try_catch`, `throw` |
+| [System Variables](#system-variables) | `$env.*`, `$auth.*`, request context |
+
+## Choosing a Filter
+
+```
+Working with...
+├── Strings?
+│   ├── Clean whitespace? → trim, ltrim, rtrim
+│   ├── Change case? → to_lower, to_upper, capitalize
+│   ├── Extract part? → substr
+│   ├── Split to array? → split
+│   ├── Find/replace? → replace, contains
+│   └── Get length? → strlen
+├── Arrays?
+│   ├── Get element? → first, last, get
+│   ├── Count items? → count
+│   ├── Transform all? → map
+│   ├── Keep some? → filter
+│   ├── Find one? → find
+│   ├── Combine? → reduce
+│   └── Sort? → sort
+├── Objects?
+│   ├── Get value? → get
+│   ├── Set value? → set
+│   ├── Check key? → has
+│   └── Extract? → keys, values
+├── Convert type?
+│   ├── To number? → to_int, to_decimal
+│   ├── To string? → to_text
+│   ├── To boolean? → to_bool
+│   └── To/from JSON? → json_encode, json_decode
+└── Check value?
+    ├── Is null? → is_null
+    ├── Is empty? → is_empty
+    └── Get type? → is_array, is_object, is_int, is_text
+```
+
 ## Quick Reference
 
 ### Operators

package/dist/xanoscript_docs/tables.md

@@ -6,6 +6,10 @@ applyTo: "table/**/*.xs"
 
 Database table definitions in XanoScript.
 
+> **TL;DR:** Every table needs `int id` as primary key. Use `auth = true` for user tables. Add indexes for frequently queried fields. Use `filters=` for validation on fields.
+
+---
+
 ## Quick Reference
 
 ```xs
@@ -311,3 +315,14 @@ table "order" {
 3. **Add indexes** for fields used in WHERE clauses and JOINs
 4. **Use appropriate types** - `email` for emails, `password` for credentials
 5. **Default timestamps** - Use `?=now` for created_at fields
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `database` | CRUD operations on tables |
+| `types` | Data types and validation |
+| `triggers` | Table triggers for CRUD events |
+| `addons` | Reusable subqueries |

package/dist/xanoscript_docs/tasks.md

@@ -257,3 +257,14 @@ task "risky_sync" {
 3. **Consider timezone** - Schedule uses UTC (+0000)
 4. **Batch operations** - Process in chunks for large datasets
 5. **Set end dates** - Use ends_on for temporary schedules
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `functions` | Reusable function stacks |
+| `database` | Database operations in tasks |
+| `debugging` | Logging and debugging task execution |
+| `triggers` | Event-driven alternatives to scheduled tasks |

package/dist/xanoscript_docs/tools.md

@@ -6,6 +6,10 @@ applyTo: "tool/**/*.xs"
 
 Functions that AI agents and MCP servers can execute.
 
+> **TL;DR:** Tools are functions for AI. Use `description` for internal docs, `instructions` for AI guidance. Define `input { }` and `stack { }` like regular functions. Attach to agents via `tools = [{ name: "tool_name" }]`.
+
+---
+
 ## Quick Reference
 
 ```xs
@@ -297,3 +301,14 @@ tool "cancel_order" {
 3. **Use enums for fixed options** - Reduces AI errors
 4. **Keep tools focused** - One task per tool
 5. **Limit response size** - Don't return huge datasets
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `agents` | AI agents that use tools |
+| `mcp-servers` | MCP servers that expose tools |
+| `functions` | Similar structure to tools |
+| `types` | Input type definitions |