@xano/developer-mcp 1.0.18 → 1.0.20

package/README.md

@@ -1,6 +1,28 @@
-# Xano Developer MCP
+<div align="center">
 
-A Model Context Protocol (MCP) server that provides AI assistants with comprehensive documentation and tools for developing applications on the Xano Headless API platform.
+# 🚀 Xano Developer MCP
+
+**Supercharge your AI with the power of Xano**
+
+[![npm version](https://img.shields.io/npm/v/@xano/developer-mcp.svg)](https://www.npmjs.com/package/@xano/developer-mcp)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+---
+
+🤖 **AI-Powered** · 📚 **Comprehensive Docs** · ⚡ **Instant Setup** · 🔧 **Built-in Tools**
+
+---
+
+</div>
+
+An MCP server that gives AI assistants superpowers for developing on [Xano](https://xano.com) — complete with documentation, code validation, and workflow guides.
+
+> 💡 **What's Xano?** The fastest way to build a scalable backend for your app — no code required. Build APIs, manage databases, and deploy instantly.
+
+### 🔗 Quick Links
+
+| 🌐 [Website](https://xano.com) | 📖 [Docs](https://docs.xano.com/) | 📝 [Blog](https://www.xano.com/blog/) | 💬 [Community](https://community.xano.com/) | 📦 [npm](https://www.npmjs.com/package/@xano/developer-mcp) |
+|:---:|:---:|:---:|:---:|:---:|
 
 ## Overview
 
@@ -22,6 +44,20 @@ claude mcp add xano-developer -- npx -y @xano/developer-mcp
 
 That's it! The MCP server will be automatically installed and configured.
 
+### Install via npm
+
+You can also install the package globally from npm:
+
+```bash
+npm install -g @xano/developer-mcp
+```
+
+Then add to Claude Code:
+
+```bash
+claude mcp add xano-developer -- xano-developer-mcp
+```
+
 ### Claude Desktop
 
 Add to your Claude Desktop configuration file:

package/dist/xanoscript_docs/apis.md

@@ -84,6 +84,30 @@ query "products" verb=GET {
 
 ---
 
+## Input Block
+
+For complete type and filter reference, use `xanoscript_docs({ keyword: "input" })`.
+
+### Empty Input Blocks
+
+**CRITICAL:** When an endpoint has no input parameters, the input block braces MUST be on separate lines. `input {}` on a single line will cause parsing errors.
+
+```xs
+// CORRECT - braces on separate lines
+query "health" verb=GET {
+  api_group = "System"
+  input {
+  }
+  stack { ... }
+  response = { status: "ok" }
+}
+
+// WRONG - causes parsing errors
+input {}
+```
+
+---
+
 ## Authentication
 
 ### Public Endpoint (default)

package/dist/xanoscript_docs/functions.md

@@ -19,6 +19,15 @@ function "<name>" {
   }
   response = $result
 }
+
+// Function with no inputs - IMPORTANT: braces must be on separate lines
+function "<name>" {
+  description = "..."
+  input {
+  }
+  stack { ... }
+  response = $result
+}
 ```
 
 ### Calling Functions
@@ -73,6 +82,33 @@ input {
 }
 ```
 
+### Empty Input Blocks
+
+**CRITICAL:** When a function has no input parameters, the input block braces MUST be on separate lines. This is a syntax requirement.
+
+```xs
+// CORRECT - braces on separate lines
+function "get_all_users" {
+  description = "Returns all users"
+  input {
+  }
+  stack {
+    db.query "user" {} as $users
+  }
+  response = $users
+}
+
+// WRONG - will cause parsing errors
+function "get_all_users" {
+  description = "Returns all users"
+  input {}    // <-- ERROR: braces must be on separate lines
+  stack {
+    db.query "user" {} as $users
+  }
+  response = $users
+}
+```
+
 ---
 
 ## Stack Block

package/dist/xanoscript_docs/tools.md

@@ -74,6 +74,25 @@ input {
 }
 ```
 
+### Empty Input Blocks
+
+**CRITICAL:** When a tool has no input parameters, the input block braces MUST be on separate lines. `input {}` on a single line will cause parsing errors.
+
+```xs
+// CORRECT - braces on separate lines
+tool "get_system_status" {
+  description = "Get current system status"
+  instructions = "Use this to check if the system is healthy"
+  input {
+  }
+  stack { ... }
+  response = $status
+}
+
+// WRONG - causes parsing errors
+input {}
+```
+
 ---
 
 ## Tool-Specific Statements

package/dist/xanoscript_docs/types.md

@@ -60,14 +60,16 @@ input {
 }
 ```
 
-**Empty Input Blocks:** When an input block has no parameters, the braces must be on separate lines:
+### Empty Input Blocks
+
+**CRITICAL:** When an input block has no parameters, the braces MUST be on separate lines. This is a strict syntax requirement - `input {}` on a single line will cause parsing errors.
 
 ```xs
-// Correct
+// CORRECT - braces on separate lines
 input {
 }
 
-// Incorrect - will cause errors
+// WRONG - causes parsing errors
 input {}
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/developer-mcp",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "MCP server for Xano Headless API documentation and XanoScript code validation",
   "type": "module",
   "main": "dist/index.js",