Documentation

Your live site

What every hosted site includes - search, tags, sitemap, social cards and an MCP endpoint for AI tools.

On this page 6

Your docs are served at the root of the site's address, such as https://yoursite.maddiedocs.com/getting-started, and at your custom domain once it's active. Every site includes the following, with nothing to set up.

Visitors search every page from the search bar or with ⌘K (Ctrl+K). Control what's found with each page's Show in search and Search ranking settings, and turn the search bar off in the theme.

Tags

Each tag you give a page gets its own page at /tag/your-tag, and /tags lists them all.

Search engines and sharing

  • Sitemap: /sitemap.xml lists every visible page for search engines, and /robots.txt points crawlers to it.
  • Social cards: pages shared on social media and chat apps show a card with the page's title and description. Pages without a Social image get one generated automatically.
  • Every page includes the title, description and structured data search engines look for.
  • One address in search results: once a custom domain is live, pages on your maddiedocs.com address tell search engines the custom domain is the one to show, so the two don't compete.

Hidden pages are left out of the sitemap and search. Set a default description and social image, or keep the whole site out of search engines, under search engines and link previews.

MCP endpoint

The MCP endpoint lets AI assistants and tools that support the Model Context Protocol search and read your docs directly, so they answer from your current documentation.

It's off by default. Turn it on from the site's Settings tab under MCP endpoint. The endpoint is your site's address followed by /mcp, such as https://yoursite.maddiedocs.com/mcp. Add that address to your AI tool as a remote MCP server.

It offers three tools:

Tool Does
search_docs Searches your pages
list_pages Lists the pages on the site
fetch_page Reads a page in full
Note

Anyone with the address can use the endpoint, just as anyone can read your live site.

To let an assistant manage your sites rather than just read them, see AI tools.

Maddie Docs badge

Every site shows a small Powered by Maddie Docs link at the bottom of each page, even when the site's footer is turned off.

On the Starter and Pro plans you can hide it: open the site's Settings tab and choose Hide badge under Maddie Docs badge. On the Free plan it's always shown. If a team moves back to Free, the badge returns, and your choice applies again after upgrading.

While a site isn't available

Visitors see When
A "Setting up" page The site is still being set up
A "Site suspended" page The site has been suspended
"This docs site could be yours" Nobody has claimed that subdomain