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).
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.
- 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.
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.
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):
{
"mcpServers": {
"axolot-cms": {
"command": "npx",
"args": ["-y", "@axolot-ai/mcp-server"],
"env": {
"AXOLOT_API_URL": "https://api.axolotcms.com"
}
}
}
}- Open Cursor and go to Settings -> Features -> MCP.
- Click "+ Add New MCP Server".
- Configure it as:
- Name:
axolot-cms - Type:
command - Command:
npx -y @axolot-ai/mcp-server
- Name:
- Add environment variables under settings if required, or log in interactively using the tools.
Once connected, the AI will automatically invoke the following tools to fulfill your design prompts:
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.
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).
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.
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.
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.
- Official Website: axolotcms.com
- Client Dashboard: ai.axolotcms.com
- Documentation & Guides: axolotcms.com/docs
- Astro SDK Repository: github.com/AxolotDevelopment/Axolot-SDK
Distributed under the MIT License. See LICENSE for more information.