@axolot-ai/mcp-server 0.0.1 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Axolot Development
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,43 +1,101 @@
-#  Axolot MCP Server
+#  Axolot MCP Server — AI-Native Headless CMS Bridge
 
-Model Context Protocol (MCP) server for Axolot CMS. Give your AI assistant "hands" to manage your website content, structure, and infrastructure.
+[![NPM Version](https://img.shields.io/npm/v/@axolot-ai/mcp-server?color=E67E22&style=flat-square)](https://www.npmjs.com/package/@axolot-ai/mcp-server)
+[![Model Context Protocol](https://img.shields.io/badge/MCP-Supported-09B5C4?style=flat-square)](https://modelcontextprotocol.io)
+[![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](https://github.com/axolot-ai/Axolot-MCP/blob/main/LICENSE)
 
-## Features
+**Axolot MCP Server** (`@axolot-ai/mcp-server`) implements Anthropic's **Model Context Protocol (MCP)** to expose your website's database schema, layouts, media library, design tokens, and module tools directly to local AI assistants (Cursor, Claude Desktop, Antigravity, VS Code, Zed).
 
-- **Master Content Tools**: List pages, read slots, and update content in real-time.
-- **Media Library Access**: Allow AI to browse and select assets for your site.
-- **Design Token Awareness**: Give AI context about your brand's colors, typography, and spacing.
-- **Zero-Effort Integration**: Works with Cursor, Claude Desktop, Zed, and any MCP-compatible client.
+By running this server, you give your AI editor context-aware "hands" to fetch, build, and optimize pages, products, blog posts, and text slots within your exact design system constraints.
 
-## Quickstart
+---
 
-### Using npx (Recommended)
+## ⚡ Key Capabilities
 
-Add this to your MCP settings (e.g., `claude_desktop_config.json`):
+*   **Surgical Content Orchestration**: The AI can query pages, read slots, and register new visual slots (`createSlot`) dynamically as it writes Astro components.
+*   **Media Library Access**: The AI browses available client assets, reading dimensions, file types, and vision-generated descriptions (`getMedia`) to select images automatically.
+*   **Brand Token Awareness**: Fetches active color schemes, font families, and spacing rules (`getDesignTokens`) to write style-compliant Tailwind or CSS code.
+*   **Module Management**: AI can query, create, or update articles in the **Blog Pro** module or products in the **Tienda Online (E-commerce)** module.
+
+---
+
+## 🔌 Setup & Configuration
+
+Since the server is a Node.js CLI tool, the recommended way to run it is via **`npx`**, which requires zero local code installation or cloning.
+
+### A. Claude Desktop Integration
+
+Add this snippet to your Claude Desktop configuration file (located at `%APPDATA%\Claude\claude_desktop_config.json` on Windows or `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
 
 ```json
 {
   "mcpServers": {
-    "axolot": {
+    "axolot-cms": {
       "command": "npx",
-      "args": ["-y", "@axolot-ai/mcp-server"]
+      "args": ["-y", "@axolot-ai/mcp-server"],
+      "env": {
+        "AXOLOT_API_URL": "https://api.axolotcms.com"
+      }
     }
   }
 }
 ```
 
-### Authentication
+### B. Cursor Integration
+
+1.  Open Cursor and go to **Settings -> Features -> MCP**.
+2.  Click **"+ Add New MCP Server"**.
+3.  Configure it as:
+    *   **Name**: `axolot-cms`
+    *   **Type**: `command`
+    *   **Command**: `npx -y @axolot-ai/mcp-server`
+4.  Add environment variables under settings if required, or log in interactively using the tools.
+
+---
+
+## 🛠️ Exposed AI Tools
+
+Once connected, the AI will automatically invoke the following tools to fulfill your design prompts:
+
+### 🔑 Authentication & Context
+*   `cms_auth_login`: Triggers a secure authorization handshake URL in your browser.
+*   `cms_auth_status`: Verifies connection status, user role, and active site.
+*   `cms_switch_site`: Switches the active site context (site ID) when managing multiple client sites.
+
+### 🎨 Brand & Design
+*   `getDesignTokens`: Fetches active brand guidelines (colors, typography, spacing, border radius).
+*   `setDesignTokens`: Updates brand tokens in the database to establish brand styling.
+*   `getSiteSettings`: Fetches core business information (address, social links, email).
+
+### 📝 Layouts & Visual Slots
+*   `getPages`: Lists all pages and their corresponding registered editable content slots.
+*   `getSlots`: Reads details and values of slots on a specific page.
+*   `createSlot`: Registers a new editable slot key (e.g. `home.hero.title`) in the database.
+*   `createPage`: Generates a new page slug in the CMS structure.
+
+### 🛍️ Modules (Blog & Shop)
+*   `getBlogPosts` / `getBlogPost`: Queries post lists, drafts, and categories.
+*   `createBlogPost` / `updateBlogPost`: Creates and updates articles.
+*   `getProducts` / `getProduct` / `createProduct`: Manages product catalogs and attributes.
+*   `getMedia`: Lists media library files with WebP URLs and alt text descriptions.
+
+---
+
+## 🔒 Security & Sandboxing
+
+The MCP server runs locally on your machine under your user context, connecting to the API via StdIO. It stores session authentication tokens securely in your user home directory at `~/.axolot/mcp-auth.json` (isolated by OS permissions). It never exposes public network ports or scans files outside your active development project directory.
 
-Once the server is running, use the following tools in your AI chat:
+---
 
-1. `cms_auth_login`: To connect your account.
-2. `cms_auth_status`: To verify the connection.
-3. `cms_switch_site`: To select the target site.
+## 🔗 Useful Links
 
-## Documentation
+*   **Official Website**: [axolotcms.com](https://axolotcms.com)
+*   **Client Dashboard**: [ai.axolotcms.com](https://ai.axolotcms.com)
+*   **Documentation & Guides**: [axolotcms.com/docs](https://axolotcms.com/docs)
+*   **Astro SDK Repository**: [github.com/AxolotDevelopment/Axolot-SDK](https://github.com/AxolotDevelopment/Axolot-SDK)
 
-Full documentation available at [axolot-cms.com/docs/mcp](https://axolot-cms.com/docs/mcp).
+---
 
-## License
+## 📄 License
 
-MIT
+Distributed under the MIT License. See `LICENSE` for more information.

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@axolot-ai/mcp-server",
-  "version": "0.0.1",
+  "version": "0.0.2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AxolotDevelopment/Axolot-MCP.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AxolotDevelopment/Axolot-MCP/issues"
+  },
+  "homepage": "https://github.com/AxolotDevelopment/Axolot-MCP#readme",
   "type": "module",
   "description": "MCP server exposing AxolotCMS tools to AI designers",
   "bin": {