[{"_1":2,"_376":-5,"_377":-5},"loaderData",{"_3":4,"_22":23,"_242":243},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",22064646,"membership","referenceId","019a38ab-d78c-7356-ab8d-f3fb85281c4a","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":41,"_158":159,"_241":145},"availableLocales",[],"githubUser","locale",{"_29":30,"_37":38,"_39":40},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Enables querying and retrieving webpage content from websites by parsing sitemap.xml files and fetching HTML content from specified URLs. Includes rate limiting protection and supports listing all available pages from a sitemap.","displayName","Webpage MCP Server","readme","# Webpage MCP Server\n\nA Model Context Protocol (MCP) server for querying webpages and page contents from a specific website.\n\n## Overview\n\nThis MCP server provides tools to list and retrieve webpage content by parsing a sitemap.xml file and fetching HTML content from specified URLs. It includes built-in rate limiting to protect against abuse.\n\n## Features\n\n- **List Pages**: Parse sitemap.xml to get all available webpage paths\n- **Get Page Content**: Fetch HTML content from any webpage\n- **Sitemap Resource**: Access the raw sitemap.xml file\n- **Rate Limiting**: 10 requests per minute per user to prevent abuse\n\n## Installation\n\n```bash\n# Install dependencies using uv\nuv sync\n\n# Or using pip\npip install -e .\n```\n\n## Configuration\n\nThe server uses environment variables for configuration:\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `BASE_URL` | The base URL of the website to query | `https://example.com` |\n| `HOST` | Server host address | `0.0.0.0` |\n| `PORT` | Server port number | `8080` |\n\n### Environment Setup\n\nCreate a `.env.local` file in the project root:\n\n```bash\nBASE_URL=https://your-website.com\nHOST=0.0.0.0\nPORT=8080\n```\n\n### Sitemap Configuration\n\nPlace your sitemap.xml file in the `assets/` directory. The server will automatically read from:\n```\nassets/sitemap.xml\n```\n\n## Usage\n\n### Running the Server\n\n**STDIO Mode (for MCP clients):**\n```bash\nuv run python src/main.py --stdio\n```\n\n**HTTP Mode:**\n```bash\nuv run python src/main.py --port 8080\n# Server will be available at http://localhost:8080/mcp\n```\n\n**Test Mode:**\n```bash\nuv run python src/main.py --test\n```\n\n### Running Tests\n\n```bash\nuv run python tests/test_server.py\n```\n\n## Available Tools\n\n### 1. list_pages()\n\nLists all webpage paths from the sitemap.\n\n**Parameters:** None\n\n**Returns:** List of page paths\n\n**Example:**\n```python\nlist_pages()\n# Returns: [\"/\", \"/blog\", \"/blog/post-1\", \"/marketplace\", \"/pricing\"]\n```\n\n### 2. get_page(path, user_id=None)\n\nFetches HTML content from a webpage.\n\n**Parameters:**\n- `path` (str): The webpage path (e.g., \"/blog/post-1\")\n- `user_id` (str, optional): User identifier for rate limiting\n\n**Returns:** Dictionary with HTML content and metadata\n\n**Example:**\n```python\nget_page(\"/blog/post-1\")\n# Returns:\n# {\n# \"path\": \"/blog/post-1\",\n# \"url\": \"https://example.com/blog/post-1\",\n# \"html\": \"...\",\n# \"status_code\": 200,\n# \"content_type\": \"text/html\"\n# }\n```\n\n**Rate Limit Response:**\n```python\n# When rate limit is exceeded:\n{\n \"error\": \"Rate limit exceeded\",\n \"message\": \"Too many requests. Please wait 45 seconds before trying again.\",\n \"reset_in_seconds\": 45,\n \"limit\": \"10 requests per minute\"\n}\n```\n\n## Available Resources\n\n### sitemap://sitemap.xml\n\nAccess the raw sitemap.xml content.\n\n**Example:**\n```xml\n\n\n \n https://example.com/\n 2025-10-08T20:10:25.773Z\n weekly\n 1\n \n ...\n\n```\n\n## Deployment\n\n### Deploy to Dedalus\n\n```bash\ndedalus deploy ./src/main.py --name 'webpage-server'\n```\n\n### Use with Dedalus SDK\n\n```python\nfrom dedalus import Dedalus\n\nclient = Dedalus(\n mcp_servers=['your-org/webpage-server']\n)\n```\n\n## Rate Limiting\n\nThe server implements rate limiting to protect against abuse:\n\n- **Limit:** 10 requests per minute per user\n- **Window:** 60 seconds rolling window\n- **Identifier:** Uses `user_id` parameter or 'default' if not provided\n\nWhen the rate limit is exceeded, the server returns an error response with:\n- Time until the limit resets\n- Total number of allowed requests\n\n## Architecture\n\n```\nmcp-server-example-python/\n├── src/\n│ └── main.py # Main server implementation\n├── assets/\n│ └── sitemap.xml # Sitemap data source\n├── tests/\n│ └── test_server.py # Test suite\n├── docs/\n│ └── README.md # This documentation\n└── pyproject.toml # Project configuration\n```\n\n## Error Handling\n\nThe server handles various error conditions gracefully:\n\n1. **Missing Sitemap:** Returns error if `assets/sitemap.xml` doesn't exist\n2. **Invalid Path:** Returns error for malformed paths\n3. **Failed HTTP Request:** Returns error with details when webpage fetch fails\n4. **Rate Limit:** Returns structured error with reset time\n\n## Development\n\n### Adding New Tools\n\nTo add a new tool, use the `@mcp.tool()` decorator:\n\n```python\n@mcp.tool()\ndef your_tool_name(param: str) -> dict:\n \"\"\"Tool description\"\"\"\n # Implementation\n return {\"result\": \"value\"}\n```\n\n### Adding New Resources\n\nTo add a new resource, use the `@mcp.resource()` decorator:\n\n```python\n@mcp.resource('resource://resource-name')\ndef get_resource() -> str:\n \"\"\"Resource description\"\"\"\n return \"resource content\"\n```\n\n## License\n\nMIT License - See LICENSE file for details\n","name","English","tag","en-US",{"_42":43,"_13":44,"_51":32,"_52":32,"_33":34,"_16":53,"_54":55,"_88":89,"_96":-5,"_97":-5,"_98":99,"_148":149,"_153":-5,"_62":136,"_154":140,"_65":155,"_156":157},"addedAt","2025-10-11T02:02:31.977299Z",[45,46,47,48,49,50],"category:web-scraping","category:browser-automation","category:search","environment:network","hosting:hybrid","language:python","descriptionMarkdown","descriptionPlainText",12478,"integrations",[56,67,74,81],{"_57":58,"_31":64,"_65":66},"brand",{"_59":60,"_37":61,"_62":63},"logoSvgPath","M24 0v24H0V0h24ZM10.933 15.89H6.84v5.52h4.198v-.93H7.955v-1.503h2.77v-.93h-2.77v-1.224h2.978v-.934Zm2.146 0h-1.084v5.52h1.035v-3.6l2.226 3.6h1.118v-5.52h-1.036v3.686l-2.259-3.687Zm5.117 0h-1.208l1.973 5.52h1.19l1.976-5.52h-1.182l-1.352 4.085-1.397-4.086ZM5.4 19.68H3.72v1.68H5.4v-1.68Z",".ENV","slug","dotenv","Uses environment variables for server configuration including base URL, host, and port settings","uid","wy6hae101m",{"_57":68,"_31":72,"_65":73},{"_59":69,"_37":70,"_62":71},"M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z","Python","python","Implemented as a Python-based MCP server with tools for parsing sitemaps and fetching webpage content","zzwi6mgd3u",{"_57":75,"_31":79,"_65":80},{"_59":76,"_37":77,"_62":78},"M.014 0h5.34v2.652H2.888v18.681h2.468V24H.015V0Zm17.622 5.049v2.78h-4.274v12.935h-3.008V7.83H6.059V5.05h11.577ZM23.986 24h-5.34v-2.652h2.467V2.667h-2.468V0h5.34v24Z","TOML","toml","Uses TOML format for project configuration through pyproject.toml file","8x90wklpoo",{"_57":82,"_31":86,"_65":87},{"_59":83,"_37":84,"_62":85},"M4.345 7.053c-.495.02-.44.725-.536 1.081-.157.583-.3 1.325-.347 1.926-.046.585-.008 1.127.066 1.719.058.46.191.767.07.89-.108.11-3.216 2.962-3.466 3.123-.26.169-.08.584.069.817.157.246.23.373.557.33.306-.042.405-.409.583-.606.228-.252 2.421-2.401 2.616-2.401.077.544.367 1.064.67 1.513.15.222.314.439.505.629.175.175.4.317.587.45.44.024.795-.301.35-.67-.17-.14-.735-.971-.927-1.43-.18-.43-.574-1.076-.146-1.428 1.494-1.23 3.72-2.262 4.247-2.313-.257 1.024-1.356 3.048-1.757 4.012-.14.333-.231.732-.185 1.094.055.434.383.774.587.806.417-.023.7-.387.946-.645.343-.357.634-.685.974-1.043.339-.356.672-.731.971-1.07.184-.207.674-.713.963-.713-.11.693-.716 1.552-.839 2.254-.125.716.531 1.596 1.217.956.623-.58 1.255-1.129 1.867-1.72.217-.208.175.037.224.242.05.208.176.91.275 1.1.18.346.496.592.897.598.362.006.727-.161.982-.414.19-.187.513-.699.154-.832-.23-.086-.217-.176-.495-.129-.172.029-.362.074-.507.179-.367-.003-.381-.89-.324-1.161.068-.327.207-.659.185-.998-.026-.418-.478-.69-.582-.72-.156-.076-.253.023-.458.212-.173.161-.363.332-.535.495-.34.322-.768.813-.942.813.305-.705.708-2.652-.643-2.48-.563.071-.95.377-1.394.71-.29.28-.683.641-.936.87-.236.216-.371.404-.496.404.132-.747 1.685-3.167.885-3.853-.158-.136-.313-.325-.515-.349a4.637 4.637 0 0 0-.833.19c-.565.18-2.78 1.28-4.19 2.289-.131.094-.214-.085-.231-.29-.087-1.058.199-2.19.496-3.188.208-.696-.557-1.225-.659-1.249zm18.177.874c-.166.364-.2.894-.248 1.319a24.307 24.307 0 0 0-1.246-.115c.238.296.691.588 1.056.724-.048.366-.434.67-.599 1.021.458-.127.676-.47.989-.821.362.22.791.627 1.26.636-.177-.376-.334-.695-.658-.966.269-.175.717-.362.924-.633-.345-.074-.718-.093-1.052-.015-.258-.284-.3-.772-.426-1.15zm-2.92.079c-.23.02-.613.49-.832.773-.807 1.039-1.542 3.15-1.661 3.542-.363 1.195-.502 2.672.28 3.722.456.612 1.258.66 2.041.434.405-.116.812-.406.95-.723.114-.263.174-.753-.404-.38-.224.145-.634.304-1.37.291-.247-.004-.651-.357-.76-.722-.192-.595-.11-1.393-.11-1.393.167-1.028.642-2.146 1.061-3.076.163-.36.658-1.259.842-1.546 0 0 .239-.373.131-.77-.031-.116-.091-.16-.168-.152zm3.072 2.976c-.12.264-.144.648-.18.956-.274-.031-.63-.066-.904-.083.172.215.501.426.766.525-.034.265-.314.486-.434.741.332-.092.49-.34.717-.596.263.16.575.456.914.462-.127-.273-.242-.504-.477-.701.195-.127.52-.262.67-.46a1.77 1.77 0 0 0-.763-.01c-.187-.206-.217-.56-.309-.834zm-1.123 2.422c-.083.183-.1.449-.125.662a12.6 12.6 0 0 0-.624-.058c.119.148.346.295.53.363-.025.184-.219.336-.301.513.23-.064.339-.236.496-.413.181.11.397.316.632.32-.088-.19-.168-.349-.33-.485.135-.087.36-.181.463-.317a1.22 1.22 0 0 0-.527-.008c-.13-.142-.151-.387-.214-.576z","XML","xml","Parses sitemap.xml files to extract webpage paths and provides access to raw XML sitemap content as a resource","237i0ki2oy","namespace",{"_90":91,"_62":95},"owner",{"_92":93},"githubAccount",{"_94":95},"login","brian-bfz","readmeMarkdown","redditPostExternalId","repository",{"_100":101,"_122":123,"_126":127,"_143":-5,"_144":145,"_146":-5,"_147":-5},"argumentsJsonSchema",{"_102":103,"_119":120,"_109":121},"properties",{"_104":105,"_111":112,"_115":116},"HOST",{"_106":107,"_31":108,"_109":110},"default","0.0.0.0","Server host address","type","string","PORT",{"_106":113,"_31":114,"_109":110},"8080","Server port number","BASE_URL",{"_106":117,"_31":118,"_109":110},"https://example.com","The base URL of the website to query","required",[],"object","githubProject",{"_35":36,"_124":125},"url","https://github.com/brian-bfz/fireworks2","githubRepository",{"_128":129,"_130":131,"_132":133,"_16":134,"_135":70,"_37":136,"_90":137,"_139":140,"_141":-5,"_142":140},"defaultBranch","main","fullName","brian-bfz/fireworks2","githubTreeId",1401600,29820,"language","fireworks2",{"_94":95,"_65":138},"arzadovxby","recentStargazers",0,"spdxLicense","stargazers","glamaJson","inspectable",false,"npmPackage","supportedPlatforms","scores",{"_150":-5,"_151":-5,"_152":-5},"license","quality","security","simpleIcon","toolCount","wh7c0vt89m","updatedAt","2025-10-11T02:02:57.029776Z","meta",[160,163,165,172,175,177,180,183,186,189,192,194,197,200,202,204,206,208,210],{"_161":162},"title","Webpage MCP Server | Glama",{"_164":32,"_37":31},"content",{"_166":167,"_168":169,"_170":171},"href","https://glama.ai/mcp/servers/@brian-bfz/fireworks2","rel","canonical","tagName","link",{"_164":34,"_173":174},"property","og:title",{"_164":32,"_173":176},"og:description",{"_164":178,"_173":179},"https://glama.ai/logo.png","og:logo",{"_164":181,"_173":182},"https://glama.ai/mcp/servers/@brian-bfz/fireworks2/og-image","og:image",{"_164":184,"_173":185},"630","og:image:height",{"_164":187,"_173":188},"1200","og:image:width",{"_164":190,"_173":191},"website","og:type",{"_164":167,"_173":193},"og:url",{"_164":195,"_173":196},"Glama – MCP Hosting Platform","og:site_name",{"_164":198,"_37":199},"summary_large_image","twitter:card",{"_164":195,"_37":201},"twitter:title",{"_164":32,"_37":203},"twitter:description",{"_164":181,"_37":205},"twitter:image",{"_164":184,"_37":207},"twitter:image:height",{"_164":187,"_37":209},"twitter:image:width",{"_211":212},"script:ld+json",{"_213":214,"_215":216},"@context","http://schema.org","@graph",[217],{"_213":218,"_219":220,"_221":222},"https://schema.org","@type","BreadcrumbList","itemListElement",[223,230,234,238],{"_219":224,"_225":226,"_37":227,"_228":229},"ListItem","item","/","Glama","position",1,{"_219":224,"_225":231,"_37":232,"_228":233},"/mcp","MCP",2,{"_219":224,"_225":235,"_37":236,"_228":237},"/mcp/servers","Servers",3,{"_219":224,"_225":239,"_37":34,"_228":240},"/mcp/servers/@brian-bfz/fireworks2",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_244":245,"_29":251,"_276":277,"_158":289,"_286":313,"_314":315},"blob",{"_164":246,"_247":248,"_249":250},".venv\n__pycache__\n*.pyc\n.env\n\n# UV package manager\nuv.lock\n.uv/","fileName",".gitignore","size",63,{"_42":43,"_13":252,"_51":32,"_52":32,"_33":34,"_16":53,"_54":253,"_88":262,"_96":-5,"_97":-5,"_98":265,"_148":275,"_153":-5,"_62":136,"_154":140,"_65":155,"_156":157},[45,46,47,48,49,50],[254,256,258,260],{"_57":255,"_31":64,"_65":66},{"_59":60,"_37":61,"_62":63},{"_57":257,"_31":72,"_65":73},{"_59":69,"_37":70,"_62":71},{"_57":259,"_31":79,"_65":80},{"_59":76,"_37":77,"_62":78},{"_57":261,"_31":86,"_65":87},{"_59":83,"_37":84,"_62":85},{"_90":263,"_62":95},{"_92":264},{"_94":95},{"_100":266,"_122":272,"_126":273,"_143":-5,"_144":145,"_146":-5,"_147":-5},{"_102":267,"_119":271,"_109":121},{"_104":268,"_111":269,"_115":270},{"_106":107,"_31":108,"_109":110},{"_106":113,"_31":114,"_109":110},{"_106":117,"_31":118,"_109":110},[],{"_35":36,"_124":125},{"_128":129,"_130":131,"_132":133,"_16":134,"_135":70,"_37":136,"_90":274,"_139":140,"_141":-5,"_142":140},{"_94":95,"_65":138},{"_150":-5,"_151":-5,"_152":-5},"member",{"_278":279,"_282":283,"_284":248,"_132":133,"_285":145,"_286":248,"_287":288,"_249":250,"_109":244},"commit",{"_280":281},"sha","f01f9665a4d70fce259ece41399ac72c2c654f7b","contentStoredObjectPointerId",15504149,"fullPath","indexable","path","safeToDisplayAsText",true,[290,292,294,296,298,299,300,302,303,304,305,306,307,308,309,310,311,312],{"_161":291},".gitignore | Webpage MCP Server | Glama",{"_164":293,"_37":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_166":295,"_168":169,"_170":171},"https://glama.ai/mcp/servers/@brian-bfz/fireworks2/blob/f01f9665a4d70fce259ece41399ac72c2c654f7b/",{"_164":297,"_173":174},".gitignore | Webpage MCP Server",{"_164":293,"_173":176},{"_164":178,"_173":179},{"_164":301,"_173":182},"https://glama.ai/generated-images/og?title=.gitignore+%7C+Webpage+MCP+Server",{"_164":184,"_173":185},{"_164":187,"_173":188},{"_164":190,"_173":191},{"_164":295,"_173":193},{"_164":195,"_173":196},{"_164":198,"_37":199},{"_164":195,"_37":201},{"_164":293,"_37":203},{"_164":301,"_37":205},{"_164":184,"_37":207},{"_164":187,"_37":209},"","treeMembers",[316,320,323,326,329,332,335,338,341,343,346,349,352,355,358,361,364,367,370,373],{"_278":317,"_284":318,"_286":318,"_109":319},{"_280":281},"agents","tree",{"_278":321,"_284":322,"_286":322,"_109":319},{"_280":281},"assets",{"_278":324,"_284":325,"_286":325,"_109":319},{"_280":281},"docs",{"_278":327,"_284":328,"_286":328,"_109":319},{"_280":281},"logs",{"_278":330,"_284":331,"_286":331,"_109":319},{"_280":281},"src",{"_278":333,"_284":334,"_286":334,"_109":319},{"_280":281},"tests",{"_278":336,"_284":337,"_286":337,"_109":244},{"_280":281},".env.example",{"_278":339,"_284":340,"_286":340,"_109":244},{"_280":281},"FLOW.md",{"_278":342,"_284":248,"_286":248,"_109":244},{"_280":281},{"_278":344,"_284":345,"_286":345,"_109":244},{"_280":281},"lib.py",{"_278":347,"_284":348,"_286":348,"_109":244},{"_280":281},"pyproject.toml",{"_278":350,"_284":351,"_286":351,"_109":244},{"_280":281},".python-version",{"_278":353,"_284":354,"_286":354,"_109":244},{"_280":281},"quick_test.py",{"_278":356,"_284":357,"_286":357,"_109":244},{"_280":281},"run_one_test.py",{"_278":359,"_284":360,"_286":360,"_109":244},{"_280":281},"run_single_test.py",{"_278":362,"_284":363,"_286":363,"_109":244},{"_280":281},"single_test.log",{"_278":365,"_284":366,"_286":366,"_109":244},{"_280":281},"test_action_generation.py",{"_278":368,"_284":369,"_286":369,"_109":244},{"_280":281},"test_cases.py",{"_278":371,"_284":372,"_286":372,"_109":244},{"_280":281},"test_kush.py",{"_278":374,"_284":375,"_286":375,"_109":244},{"_280":281},"test_results.log","actionData","errors"]

MCP directory API