Sitemap

Sitemap MCP Server lets you fetch, parse, and visualize website sitemaps from any URL, enabling you to analyze site structure, uncover hidden pages, and extract organized hierarchies with structured MCP tools and ready-made prompts.

How to use

You use this MCP server by connecting your MCP client to the Sitemap MCP Server and then running the provided tools or prompts to fetch sitemap data, filter pages, inspect statistics, or visualize the sitemap structure. Practical workflows include pulling a complete sitemap for a site, paginating through large sitemap collections, filtering by specific routes or subsitemaps, and parsing sitemap content directly from XML.

How to install

Prerequisites: you need the uv runtime available on your system.

Install in Claude Desktop, Cursor or Windsurf by adding this MCP server entry to your client configuration file.

{
  "mcpServers": {
    "sitemap": {
      "command": "uvx",
      "args": ["sitemap-mcp-server"],
      "env": { "TRANSPORT": "stdio" }
    }
  }
}

Restart Claude if it is running. For Cursor, simply refresh or enable the MCP Server in the settings.

Install via Smithery to automatically install Sitemap for Claude Desktop.

npx -y @smithery/cli install @mugoosse/sitemap --client claude

MCP Inspector and transports

Use the MCP Inspector to connect to the Sitemap MCP Server with either stdio or SSE transport.

npx @modelcontextprotocol/inspector env TRANSPORT=stdio uvx sitemap-mcp-server

Open the MCP Inspector at http://127.0.0.1:6274, select stdio transport, and connect to the MCP server.

SSE Transport

If you prefer SSE transport, start the server and configure your MCP Client to use SSE.

uvx sitemap-mcp-server

Configure your MCP Client, for example Cursor, with the following settings.

{
  "mcpServers": {
    "sitemap": {
      "transport": "sse",
      "url": "http://localhost:8050/sse"
    }
  }
}

Local development

For building and running from source, follow the DEVELOPERS.md guidance for your environment.

Usage

Available actions are exposed as tools and prompts inside your MCP client. You can fetch a sitemap tree, get sitemap pages with optional filtering and pagination, retrieve statistics for a site’s sitemaps, and parse sitemap content directly from XML.

Prompts appear as templates in Claude Desktop and can guide you through sitemap analysis tasks with just a URL input.

Examples

Fetch a complete sitemap from a site.

Get pages with filtering and pagination to navigate large sitemaps.

Parse sitemap content directly from an XML snippet.

Notes and best practices

Use cursor-based pagination for large sitemaps to efficiently retrieve pages in chunks and avoid overwhelming responses.

Leverage the ready-to-use prompts to quickly perform common sitemap analysis tasks without constructing complex queries.

Troubleshooting

If the MCP Inspector cannot connect, verify that the server is running and that the configured transport URL matches the active transport (stdio or SSE). Check that TRANSPORT is set to stdio when using the stdio flow.

Available tools

get_sitemap_tree

Fetch and parse the sitemap tree from a website URL, returning a JSON representation of the sitemap hierarchy.

get_sitemap_pages

Get all pages from a website's sitemap with options for limit, metadata, route, sitemap_url, and cursor-based pagination.

get_sitemap_stats

Retrieve statistics about a website's sitemap, including total counts and details for subsitemaps.

parse_sitemap_content

Parse sitemap content directly from an XML or text payload and return a structured JSON representation.