Skip to main content
Glama
Sign In
enesjakozh

Sitemap MCP Server

by mugoosse
Verified
GitHub
Python
MIT License
1
  • Apple
  • Linux
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • References GitHub for project repository and asset hosting, though not a core integration

  • Handles Google News sitemaps, allowing for fetching and analyzing news-specific sitemap data

  • Creates Mermaid.js diagrams to visualize sitemap structures through the provided sitemap visualization prompts

Sitemap MCP Server

The Sitemap MCP Server provides AI agents and MCP clients with powerful tools for fetching, parsing, analyzing, and visualizing website sitemaps. It handles all standard sitemap formats including XML, Google News, and plain text sitemaps.

Demo

Get answers to questions about any website leveraging the power of sitemaps.

Click on the "attach" button next to the tools button:

Then select visualize_sitemap:

Now we enter windsurf.com:

And we get a visualization of teh sitemap:

Installation

Make sure uv is installed.

Installing in Claude Desktop, Cursor or Windsurf

Add this entry to your claude_desktop_config.json, Cursor settings, etc.:

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

Restart Claude if it's running. For Cursor simply press refresh and/or enable the MCP Server in the settings.

Installing via Smithery

To install sitemap for Claude Desktop automatically via Smithery:

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

MCP Inspector

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.

# Start the server uvx sitemap-mcp-server # Start the MCP Inspector in a separate terminal npx @modelcontextprotocol/inspector connect http://127.0.0.1:8050

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

SSE Transport

If you want to use the SSE transport, follow these steps:

  1. Start the server:
uvx sitemap-mcp-server
  1. Configure your MCP Client, e.g. Cursor:
{ "mcpServers": { "sitemap": { "transport": "sse", "url": "http://localhost:8050/sse" } } }

Local Development

For instructions on building and running the project from source, please refer to the DEVELOPERS.md guide.

Usage

Tools

The following tools are available via the MCP server:

  • get_sitemap_tree - Fetch and parse the sitemap tree from a website URL
    • Arguments: url (website URL), include_pages (optional, boolean)
    • Returns: JSON representation of the sitemap tree structure
  • get_sitemap_pages - Get all pages from a website's sitemap with filtering options
    • Arguments: url (website URL), limit (optional), include_metadata (optional), route (optional), sitemap_url (optional), cursor (optional)
    • Returns: JSON list of pages with pagination metadata
  • get_sitemap_stats - Get statistics about a website's sitemap
    • Arguments: url (website URL)
    • Returns: JSON object with sitemap statistics including page counts, modification dates, and subsitemap details
  • parse_sitemap_content - Parse a sitemap directly from its XML or text content
    • Arguments: content (sitemap XML content), include_pages (optional, boolean)
    • Returns: JSON representation of the parsed sitemap

Prompts

The server includes ready-to-use prompts that appear as templates in Claude Desktop. After installing the server, you'll see these templates in the "Templates" menu (click the + icon next to the message input):

  • Analyze Sitemap: Provides comprehensive structure analysis of a website's sitemap
  • Check Sitemap Health: Evaluates SEO and health metrics of a sitemap
  • Extract URLs from Sitemap: Extracts and filters specific URLs from a sitemap
  • Find Missing Content in Sitemap: Identifies content gaps in a website's sitemap
  • Visualize Sitemap Structure: Creates a Mermaid.js diagram visualization of sitemap structure

To use these prompts:

  1. Click the + icon next to the message input in Claude Desktop
  2. Select the desired template from the list
  3. Fill in the website URL when prompted
  4. Claude will execute the appropriate sitemap analysis

Examples

Fetch a Complete Sitemap

{ "name": "get_sitemap_tree", "arguments": { "url": "https://example.com", "include_pages": true } }

Get Pages with Filtering and Pagination

Filter by Route
{ "name": "get_sitemap_pages", "arguments": { "url": "https://example.com", "limit": 100, "include_metadata": true, "route": "/blog/" } }
Filter by Specific Subsitemap
{ "name": "get_sitemap_pages", "arguments": { "url": "https://example.com", "limit": 100, "include_metadata": true, "sitemap_url": "https://example.com/blog-sitemap.xml" } }
Cursor-Based Pagination

The server implements MCP cursor-based pagination to handle large sitemaps efficiently:

Initial Request:

{ "name": "get_sitemap_pages", "arguments": { "url": "https://example.com", "limit": 50 } }

Response with Pagination:

{ "base_url": "https://example.com", "pages": [...], // First batch of pages "limit": 50, "nextCursor": "eyJwYWdlIjoxfQ==" }

Subsequent Request with Cursor:

{ "name": "get_sitemap_pages", "arguments": { "url": "https://example.com", "limit": 50, "cursor": "eyJwYWdlIjoxfQ==" } }

When there are no more results, the nextCursor field will be absent from the response.

Get Sitemap Statistics

{ "name": "get_sitemap_stats", "arguments": { "url": "https://example.com" } }

The response includes both total statistics and detailed stats for each subsitemap:

{ "total": { "url": "https://example.com", "page_count": 150, "sitemap_count": 3, "sitemap_types": ["WebsiteSitemap", "NewsSitemap"], "priority_stats": { "min": 0.1, "max": 1.0, "avg": 0.65 }, "last_modified_count": 120 }, "subsitemaps": [ { "url": "https://example.com/sitemap.xml", "type": "WebsiteSitemap", "page_count": 100, "priority_stats": { "min": 0.3, "max": 1.0, "avg": 0.7 }, "last_modified_count": 80 }, { "url": "https://example.com/blog/sitemap.xml", "type": "WebsiteSitemap", "page_count": 50, "priority_stats": { "min": 0.1, "max": 0.9, "avg": 0.5 }, "last_modified_count": 40 } ] }

This allows MCP clients to understand which subsitemaps might be of interest for further investigation. You can then use the sitemap_url parameter in get_sitemap_pages to filter pages from a specific subsitemap.

Parse Sitemap Content Directly

{ "name": "parse_sitemap_content", "arguments": { "content": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"><url><loc>https://example.com/</loc></url></urlset>", "include_pages": true } }

Acknowledgements

License

This project is licensed under the MIT License. See the LICENSE file for details.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

Sitemap MCP Server

  1. Demo
    1. Installation
      1. Installing in Claude Desktop, Cursor or Windsurf
      2. Installing via Smithery
      3. MCP Inspector
      4. SSE Transport
      5. Local Development
    2. Usage
      1. Tools
      2. Prompts
      3. Examples
    3. Acknowledgements
      1. License

        Related Resources

        ID: 07w9m4uqkl