stukennedy/html-surf-claude-skill/html-surf-knowledge-graph

html.surf Knowledge Graph

Use this skill when a user wants Claude to work with pages stored in html.surf.

MCP Server

Connect to:

https://html.surf/mcp

The server uses Streamable HTTP and OAuth with PKCE and Dynamic Client Registration.

What Claude Can Do

• Search accessible html.surf pages.
• Read full page content, including HTML and plain text.
• Follow links and backlinks across the page graph.
• List public pages or authenticated private pages.
• Validate generated HTML before saving it.
• Create or update pages when the user authorizes write access.
• Manage bookmarks, share links, permissions, themes, and assets through MCP tools.

Example Prompts

• "Search html.surf for my product planning pages, follow the linked research notes, and summarize the top release risks."
• "Read my architecture overview on html.surf, follow its linked pages, and explain the data flow and unresolved design questions."
• "Draft a private html.surf page for my launch checklist, validate the HTML, and save it under launch/checklist."
• "List my html.surf pages about customer onboarding, then follow backlinks to find related implementation notes."

User Guidance

Ask the user to connect Claude to https://html.surf/mcp and complete the OAuth flow. Public pages can be read without authentication; private pages and writes require an html.surf account.