mcpbeat

HTML Email Playbook MCP Server

io.github.OsamaHassouna/email-playbook-mcp
not responding

HTML Email Playbook is listed as active in the registry but did not answer our last check. 57 installs a week from npm. It exposes 4 tools. Last commit 2 Jun 2026.

Teaches AI to write HTML email that renders in Outlook, Gmail, and Apple Mail. 19 rules, 6 comps.

Installs per day peak 32 · avg 9 · +0% w/w
a month agotoday
Uptime history 39 hours of history · worst hour 0%
39 hours agonow
0.0%
Uptime 24h
0 of 91 checks
4
Tools
read from the server
209 ms
Response time
average over 24h
57
Installs / week
npm and PyPI

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 10 min ago.

run in your terminal
claude mcp add email-playbook-mcp --transport http https://docs.osamahassouna.com/api/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "email-playbook-mcp": {
      "url": "https://docs.osamahassouna.com/api/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.email-playbook-mcp]
url = "https://docs.osamahassouna.com/api/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "email-playbook-mcp": {
      "url": "https://docs.osamahassouna.com/api/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "email-playbook-mcp": {
      "url": "https://docs.osamahassouna.com/api/mcp"
    }
  }
}

Available tools 4

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

categories
list_categories
List all rule categories in the Email Playbook with a one-line description and page count. Categories are: structure (head/body container/header/body/footer), compatibility (Outlook MSO, RTL, responsive), production (Gmail clipping, dark mode, preheader, bulletproof buttons), ai-generation (constraints for AI emitters). For reusable components, use list_components instead — they live in a separate dimension and are not returned by get_playbook_rules.
component
get_component
Return the full record for a single component: title, description, narrative body, the primary HTML pattern, list of slots (placeholders the model should fill), VML/responsive flags, and all code examples. Use after list_components to fetch the actual HTML pattern to paste into an email.
components
list_components
List all reusable email components in the playbook with their metadata: name, subcategory (layout/media/interactive/text), description, whether they require Outlook VML, and whether they are responsive. Use this first to discover what components exist before calling get_component.
playbook
get_playbook_rules
Return the full rule pages for a given category. Each rule includes the title, description, markdown body explaining the rule, and any HTML/CSS code examples from the playbook. Use this to teach a model the exact patterns for a specific concern (e.g., responsive layout).

Endpoints

URLTransportStateLatencyChecked
https://docs.osamahassouna.com/api/mcp streamable-http answering 209 ms 10 min ago

HTML Email Playbook — questions

Answers built from our own checks of this server.

What can HTML Email Playbook do?
It exposes 4 tools, read directly from the server on our last check. Among them: get_component, get_playbook_rules, list_categories, list_components. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is HTML Email Playbook working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 0 of 91 checks got a reply (0.0%), average response time 209 ms. The bar chart above shows every period we have measured.
The registry lists HTML Email Playbook as active — why does it not respond?
The official MCP registry stores what the author submitted; it does not verify that the server still runs. We check the endpoint ourselves, and this one does not answer. Catalogues that copy the registry without checking will show it as working.
How do I connect HTML Email Playbook?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does HTML Email Playbook need an API key?
No. HTML Email Playbook completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 4 of them are readable on this page. This is what we observed, not what the docs claim.
How many people use HTML Email Playbook?
The npm package email-playbook-mcp was installed 57 times in the last week. Week over week that is +0%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is HTML Email Playbook open source?
Yes — it is published under the MIT licence, written in MDX and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.