• HIERARCHY
  • ROUTING
  • AUDIT
  • HUMAN

How to map site architecture with your AI

Connect Agility CMS to your AI client once. From there, your agent can pull live data to visualize your entire content structure.

Ask AI about this page

Short answer

How can I map my site architecture with AI?

Your AI uses Agility CMS tools to fetch the complete site tree and a flat list of all routes. This lets you instantly generate visual hierarchies or URL maps. You get a clear view of your content organization and routing logic.

The results of your audit

What your AI produces

The data your agent pulls from Agility CMS falls into these categories.

HIERARCHY

Visual site trees

The AI pulls the nested content structure. You get a clear map of how pages and folders relate to each other.

ROUTING

Flat URL lists

Your agent grabs every active route. This makes it easy to audit your URL patterns and link structures.

AUDIT

Structure analysis

The AI identifies deep nesting or broken paths. You get a list of structural issues to fix manually.

HUMAN

Manual adjustments

The AI only reads the structure. You still need to go into Agility CMS to move content or change slugs.

The workflow

What your AI does when the data arrives.

The AI handles the heavy lifting of traversing your CMS content.

  1. Fetch the tree

    Your agent crawls the content hierarchy to understand the parent-child relationships between pages.

    get_site_tree

  2. Extract routes

    The AI pulls a flat list of every URL path defined in your CMS.

    get_site_flat_router

  3. Map relationships

    Your agent combines the tree and the routes to show how specific URLs sit within the folder structure.

    get_site_treeget_site_flat_router

  4. Identify gaps

    The AI looks for orphaned pages or inconsistent URL patterns based on the data it just pulled.

    get_site_flat_router

Try it

Copy these to start.

Use these prompts to begin your architectural audit.

Starting points

These are opening lines. Swap out the specific folder names or site names to match your Agility CMS setup.

Agility CMS Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_5eswiSmSUebcV9cwXlY54rj1CtGkp8fDqrTfU030/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Agility CMS capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "agility-cms-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_5eswiSmSUebcV9cwXlY54rj1CtGkp8fDqrTfU030/mcp"
    }
  }
}
Copy into chat04

  • Show me the full site tree for my production environment.

  • List all the URLs in my site using the flat router map.

  • Analyze the site tree and tell me if any folders are too deep.

  • Compare the site tree to the flat router to find any missing URL paths.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Agility CMS once, then ask.

Just link your account. Your credentials stay encrypted, and you can immediately start asking your AI about your site structure.

Connect Agility CMS to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my site structure?

    No. The AI can only read the site tree and router maps. It cannot move pages or edit content in Agility CMS.

  • 02

    Can the AI delete any content?

    No. This MCP is read-only. It has no tools to delete or modify your data.

  • 03

    Does the AI see all my content?

    It sees whatever is exposed through the site tree and router tools. It cannot access content outside those specific structures.

  • 04

    How does the AI know my URL structure?

    It uses the flat router tool to get a list of all defined paths.

  • 05

    Can I use this with Claude?

    Yes, as long as you use an MCP-compatible client like Claude Desktop.

  • More questions about Agility CMS? The Connector page answers them. See everything the Agility CMS Connector can do

Connect Agility CMS to Claude, Cursor, ChatGPT & more