Axolot Logo

Master Server

Deep dive into the content orchestration engine that gives your AI assistant full context of your site's structure.

The Master MCP Server is the primary interface between your AI assistant and your content. It doesn't just manage strings; it understands the relationship between pages, slots, and modules.

Content Discovery Tools

These tools allow the AI to build a mental map of your site before proposing changes.

listPages() Read Tool

Returns a list of all discovered pages on the site, including their slugs and titles. The AI uses this to navigate the site structure.

Returns: Array<{ title: string, slug: string, id: string }>
getSlots(pageId) Read Tool

Fetches every editable slot on a specific page. It includes the current value, the type (text, image, etc.), and any AI hints defined in code.

Returns: Array<{ key: string, value: any, type: string, aiHint: string }>
getMedia() Read Tool

Provides access to the shared media library. The AI can use this to browse images, read their AI-generated alt text, and select assets for replacement.

Returns: Array<{ url: string, alt: string, dimensions: string }>

Action & Modification Tools

When the AI is ready to act, it uses these tools to trigger the Surgical Parser.

  • updateSlot(key, value): The heavy hitter. It updates any slot on the current site. The AI validates the value against the slot type before calling this.
  • createPage(title, slug): Scaffolds a new entry in the CMS database. Note: The AI cannot create the .astro file directly via MCP (for security), but it prepares the CMS to receive content for the new route.
  • createSlot(pageId, key, label, type): Dynamically registers a new slot. Useful when the AI generates a new component and wants to make it editable instantly.