{
"name": "HTML Docs Agent Compatibility Matrix 2026",
"version": "2.0",
"canonical_url": "https://www.html-docs.com/plugins#compatibility-matrix",
"author": "Raunaq Naidu",
"publisher": "HTML Docs",
"date_published": "2026-08-24",
"date_modified": "2026-10-09",
"json_url": "https://www.html-docs.com/research/html-docs-agent-compatibility-matrix-2026.json",
"csv_url": "https://www.html-docs.com/research/html-docs-agent-compatibility-matrix-2026.csv",
"bibtex_url": "https://www.html-docs.com/research/html-docs-agent-compatibility-matrix-2026.bib",
"citation_file_url": "https://www.html-docs.com/research/html-docs-agent-compatibility-matrix-2026.cff",
"citation": "Raunaq Naidu, ‘HTML Docs Agent Compatibility Matrix 2026,’ version 2.0, HTML Docs, October 9, 2026.",
"markdown_citation": "[HTML Docs Agent Compatibility Matrix 2026](https://www.html-docs.com/plugins#compatibility-matrix) — Raunaq Naidu, HTML Docs, version 2.0, October 9, 2026.",
"html_citation": "HTML Docs Agent Compatibility Matrix 2026 — Raunaq Naidu, HTML Docs, version 2.0, October 9, 2026.",
"methodology": "Product installation paths were verified against the HTML Docs website and public installer behavior. Protocol-compatible paths were checked against the named client's official MCP documentation. Version 2.0 adds a row-level primary source and verification date so every compatibility claim can be audited without inferring evidence from a shared bibliography. Client plan availability, workspace policy, and confirmation behavior remain controlled by the client vendor.",
"composition_pattern": {
"name": "A skill defines the workflow; MCP exposes the operations.",
"summary": "HTML Docs keeps production judgment and system integration in separate, composable layers. The skill tells an agent how to gather sources, preserve evidence, design an accessible artifact, run review gates, and ask before publication. The MCP server exposes typed operations for storing, revising, reviewing, and versioning the resulting document.",
"skill": {
"role": "Defines source capture, evidence tracking, responsive document design, accessibility checks, review gates, and explicit publication approval.",
"install": "npx skills add raunaqbn/html-docs-skill --skill html-docs -g",
"source": "https://github.com/raunaqbn/html-docs-skill/tree/main/html-docs"
},
"mcp": {
"role": "Provides typed tools to create documents, read and update regions, manage inline comments, and work with document versions.",
"endpoint": "https://www.html-docs.com/mcp",
"reference": "https://www.html-docs.com/developers#mcp-server"
},
"example_prompt": "Use the HTML Docs skill to turn this repository into a source-grounded onboarding guide. Keep the page private while you create it through the HTML Docs MCP, then return the review URL and wait for comments before publishing anything publicly."
},
"sources": [
"https://www.html-docs.com/developers#mcp-server",
"https://www.html-docs.com/create",
"https://github.com/raunaqbn/html-docs-skill",
"https://github.com/raunaqbn/html-docs-claude-plugin",
"https://www.npmjs.com/package/@html-docs/cli",
"https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp",
"https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md",
"https://help.openai.com/en/articles/12584461-developer-mode-and-full-mcp-connectors-in-chatgpt",
"https://muse.ai/platform/docs",
"https://about.fb.com/news/2026/09/introducing-muse-small-business/",
"https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/extend-copilot-chat-with-mcp?tool=vscode",
"https://docs.devin.ai/desktop/cascade/mcp",
"https://modelcontextprotocol.io/specification/2025-11-25/basic/transports"
],
"clients": [
{
"client": "Claude",
"recommended_path": "Hosted custom connector",
"connection": "https://www.html-docs.com/mcp",
"transport": "Streamable HTTP",
"authentication": "Browser OAuth",
"support_level": "direct-setup",
"note": "Anthropic documents remote custom connectors for Free, Pro, Max, Team, and Enterprise plans; Free accounts are limited to one custom connector, while organization policy controls Team and Enterprise setup. The HTML Docs link opens the connector dialog with the name and endpoint prefilled.",
"source_url": "https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp",
"verified_at": "2026-10-09"
},
{
"client": "Claude Code",
"recommended_path": "Claude plugin or hosted MCP",
"connection": "claude plugin marketplace add raunaqbn/html-docs-claude-plugin && claude plugin install html-docs@html-docs",
"transport": "Streamable HTTP",
"authentication": "Browser OAuth",
"support_level": "direct-setup",
"note": "Subscription sessions can inherit the Claude connector; other sessions can install the public plugin.",
"source_url": "https://github.com/raunaqbn/html-docs-claude-plugin",
"verified_at": "2026-10-09"
},
{
"client": "ChatGPT",
"recommended_path": "Custom MCP app on web",
"connection": "https://www.html-docs.com/mcp",
"transport": "Streamable HTTP",
"authentication": "Browser OAuth",
"support_level": "plan-dependent",
"note": "OpenAI documents full MCP, including write actions, for Business and Enterprise/Edu on ChatGPT web. Pro can use custom apps for read and fetch in developer mode; workspace role and policy control creation and publication.",
"source_url": "https://help.openai.com/en/articles/12584461-developer-mode-and-full-mcp-connectors-in-chatgpt",
"verified_at": "2026-10-09"
},
{
"client": "Codex",
"recommended_path": "HTML Docs installer",
"connection": "npx @html-docs/cli install",
"transport": "Installer-managed MCP configuration",
"authentication": "HTML Docs account",
"support_level": "installer-supported",
"note": "The installer detects Codex and adds the HTML Docs MCP configuration.",
"source_url": "https://www.html-docs.com/create",
"verified_at": "2026-10-09"
},
{
"client": "Meta Muse",
"recommended_path": "Custom API connector",
"connection": "https://www.html-docs.com/connectors/muse/connector.md",
"transport": "Muse custom connector",
"authentication": "Dedicated HTML Docs API key in Muse secure credentials",
"support_level": "custom-connector",
"note": "Meta documents custom connectors and secure credential requirements. The HTML Docs connector brief supplies a no-dependency Python adapter, exact API contracts, least-privilege handling, and a private verification workflow; it is not a built-in Muse directory listing.",
"source_url": "https://muse.ai/platform/docs",
"verified_at": "2026-10-09"
},
{
"client": "Cursor",
"recommended_path": "HTML Docs installer",
"connection": "npx @html-docs/cli install",
"transport": "Installer-managed MCP configuration",
"authentication": "HTML Docs account",
"support_level": "installer-supported",
"note": "The installer detects Cursor and adds the HTML Docs MCP configuration.",
"source_url": "https://www.html-docs.com/create",
"verified_at": "2026-10-09"
},
{
"client": "Windsurf",
"recommended_path": "HTML Docs installer",
"connection": "npx @html-docs/cli install",
"transport": "Installer-managed MCP configuration",
"authentication": "HTML Docs account",
"support_level": "installer-supported",
"note": "The installer detects Windsurf and adds the HTML Docs MCP configuration.",
"source_url": "https://www.html-docs.com/create",
"verified_at": "2026-10-09"
},
{
"client": "Cline",
"recommended_path": "HTML Docs installer",
"connection": "npx @html-docs/cli install",
"transport": "Installer-managed MCP configuration",
"authentication": "HTML Docs account",
"support_level": "installer-supported",
"note": "The installer detects Cline and adds the HTML Docs MCP configuration.",
"source_url": "https://www.html-docs.com/create",
"verified_at": "2026-10-09"
},
{
"client": "Gemini CLI",
"recommended_path": "Manual settings.json entry",
"connection": "\"httpUrl\": \"https://www.html-docs.com/mcp\"",
"transport": "Streamable HTTP",
"authentication": "Browser OAuth",
"support_level": "protocol-compatible",
"note": "Gemini CLI documents Streamable HTTP and automatic OAuth discovery; confirm with /mcp auth after adding the endpoint.",
"source_url": "https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md",
"verified_at": "2026-10-09"
},
{
"client": "GitHub Copilot (VS Code)",
"recommended_path": "Remote MCP server in mcp.json",
"connection": "\"url\": \"https://www.html-docs.com/mcp\"",
"transport": "Streamable HTTP",
"authentication": "Browser OAuth",
"support_level": "protocol-compatible",
"note": "Requires VS Code 1.99+ and an enabled MCP policy on managed plans. Copilot cloud agent is excluded because it does not support OAuth-authenticated remote MCP servers.",
"source_url": "https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/extend-copilot-chat-with-mcp?tool=vscode",
"verified_at": "2026-10-09"
},
{
"client": "Devin Desktop (legacy Cascade)",
"recommended_path": "Remote HTTP in mcp_config.json",
"connection": "\"serverUrl\": \"https://www.html-docs.com/mcp\"",
"transport": "Streamable HTTP",
"authentication": "Browser OAuth",
"support_level": "protocol-compatible",
"note": "Official docs cover Streamable HTTP and OAuth; team policy can disable or allowlist MCP. This config applies to legacy Cascade, not the default Devin Local Agent.",
"source_url": "https://docs.devin.ai/desktop/cascade/mcp",
"verified_at": "2026-10-09"
},
{
"client": "Other MCP clients",
"recommended_path": "Manual remote-server setup",
"connection": "https://www.html-docs.com/mcp",
"transport": "Streamable HTTP",
"authentication": "Client-dependent",
"support_level": "protocol-compatible",
"note": "Requires Streamable HTTP plus MCP OAuth support for the hosted, account-scoped connection.",
"source_url": "https://modelcontextprotocol.io/specification/2025-11-25/basic/transports",
"verified_at": "2026-10-09"
}
]
}