
HTML to Image
HTML to Image is a service that converts HTML and CSS into images or captures screenshots of web pages.
Verdict
Common use cases
- Generate Open Graph images from blog drafts
- Render email templates for client review
- Create social cards from event metadata
- Snapshot dynamic charts as static PNGs
- Prototype hero banners with live copy
Integration
- Vendor
- HTML to Image
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 3
- Composio slug
html_to_image
Tools
- Check HTML-to-Image Account Usage
Tool to retrieve account usage statistics including hourly, daily, and monthly image creation counts. Use after authenticating to review current usage limits and billing periods.
- Convert HTML to Image
Tool to convert HTML content into an image. Returns either a downloadable file or a JSON payload containing id and url, depending on the upstream API behavior.
- Get HTML to Image
Tool to retrieve a generated image by its ID. Use when you need to fetch, resize, or download an existing HTML to image asset.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the MCP Integrations tab. 2. Click 'Add Integration' and select 'HTML to Image' from the developer tools category. 3. Visit htmlcsstoimage.com, sign up or log in, then copy your API key from the account dashboard. 4. Paste the key into Switchy's configuration modal and click 'Connect'. 5. Open any Space, type '@HTML to Image check my account usage' and send — if you see hourly, daily, and monthly counts, the connection is live. 6. To render an image, @mention the MCP with HTML content and any sizing parameters; it returns a URL or file you can preview inline.
What teammates see: by default, memories from HTML to Image are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Check Usage Limits
@HTML to Image check my account usage and tell me how many images I have left this month.Open in a Space →
Social Card from Headline
@HTML to Image convert this HTML to a 1200×630 image: <div style='background:linear-gradient(135deg,#667eea,#764ba2);color:white;padding:60px;font:bold 48px sans-serif'>Launch Week Starts Monday</div>Open in a Space →
Email Template Preview
@HTML to Image render this email header as an image: <table width='600'><tr><td style='background:#f4f4f4;padding:20px;text-align:center'><h1>Welcome to Acme</h1></td></tr></table>Open in a Space →
Retrieve Existing Image
@HTML to Image get the image with ID abc123 and show me the download link.Open in a Space →
Chart Snapshot for Report
@HTML to Image create a 800×400 image from this chart HTML: <div style='display:flex;gap:10px;align-items:flex-end;height:200px'><div style='width:40px;background:blue;height:80%'></div><div style='width:40px;background:green;height:60%'></div></div>Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@HTML to Image convert this HTML snippet into a PNG: <div style='padding:20px;background:#f0f0f0;font-family:sans-serif'><h1>Q4 Revenue</h1><p>$2.3M</p></div>
I've converted your HTML into a PNG image. The rendered output shows a light gray card with 'Q4 Revenue' as a heading and '$2.3M' below it in sans-serif font. The image is available at https://hcti.io/v1/image/abc123def456 and can be downloaded or embedded directly. The asset ID is abc123def456 if you need to retrieve or resize it later.
This example demonstrates the core HTML-to-image conversion capability. The MCP returns either a direct file or a JSON object with an image URL depending on API configuration. Requires a valid API key with sufficient monthly quota. Useful for generating social media cards, email banners, or report thumbnails from markup.
@HTML to Image check my current usage stats — how many images have I generated this month and what's my limit?
Your HTML to Image account usage for the current billing period: You've created 847 images this month out of a 5,000-image monthly limit (16.9% used). Today you've generated 23 images, and in the last hour you created 2 images. Your billing period resets on the 15th of each month.
This read-only query helps teams monitor API consumption before hitting rate limits. The MCP fetches hourly, daily, and monthly counters along with your plan's ceiling. Use this proactively in Spaces where multiple teammates generate images to avoid unexpected quota exhaustion or overage charges.
@HTML to Image retrieve image ID 7f8e9a0b1c2d and tell me what it contains, then resize it to 800x600 if possible.
I've retrieved image 7f8e9a0b1c2d from your HTML to Image account. The original asset is a 1200x900 PNG showing a dashboard layout with three metric cards. The API doesn't support in-place resizing via this tool, but you can re-render the source HTML with updated viewport dimensions using the Convert tool if you still have the original markup.
This example shows the retrieval workflow for previously generated images. The Get tool fetches metadata and the image URL by ID, but resizing requires re-conversion with new parameters rather than post-processing. Keep image IDs in your Space's context if you plan to reference or iterate on assets across multiple prompts.
Use-case deep-dives
When this MCP beats manual screenshots for recurring reports
A 6-person ops team sends weekly dashboard summaries to stakeholders who don't log into analytics tools. They used to screenshot Metabase charts manually every Friday morning. The HTML to Image MCP converts their dashboard HTML into PNGs on a schedule, then drops them into Slack or email templates. The Convert HTML to Image tool handles the render; the Get tool lets them resize for mobile previews. This works if your HTML is self-contained (inline CSS, no external fonts that need auth). If your dashboards require live OAuth tokens or complex JavaScript state, you'll hit rendering failures. The MCP shines when your report markup is static or templated, and you're generating more than 10 images a month.
Why this MCP fits dynamic Open Graph image pipelines
A 3-person content team publishes blog posts to a headless CMS and wants unique Open Graph images for each article without hiring a designer. They template the post title and author into an HTML card, then call Convert HTML to Image at publish time to generate the og:image asset. The MCP returns a URL they store in the CMS metadata field. The Check Account Usage tool keeps them under their monthly cap during high-volume launches. This approach works when your card design is consistent and text-driven. If you need photo compositing or brand-heavy layouts with licensed fonts, a design tool like Figma's API or Bannerbear is a better fit. The MCP is the right call when you're shipping 20-100 posts a month and speed matters more than pixel-perfect design.
When this MCP simplifies transactional document generation
A 5-person SaaS support team sends personalized onboarding PDFs to new trial users. The PDF includes the user's workspace name, plan tier, and a QR code linking to their setup guide. They render the page as HTML in their backend, pass it to Convert HTML to Image, then embed the PNG in a PDF wrapper or email. The Get tool lets them cache the image by ID for resends. This pattern works if your document is a single page and doesn't need multi-page layouts or fillable form fields. If you're generating 10-page contracts or need legal-grade PDF/A compliance, a dedicated PDF service like DocRaptor is the move. The MCP wins when you need a lightweight, one-page visual artifact and you're already comfortable writing HTML templates.
Frequently asked
What does the HTML to Image MCP do in Switchy?
It converts HTML snippets into PNG or JPEG images directly from your Switchy workspace. You can generate screenshots of web content, create social media cards from templates, or turn dynamic HTML into static images without running a headless browser yourself. The MCP handles rendering and returns either a download link or a JSON payload with the image URL.
Do I need an HTML to Image API key to use this MCP?
Yes. The MCP uses API key authentication, so you'll need an active HTML to Image account and a valid API key. Paste the key into Switchy's connection flow once, and the MCP will authenticate all subsequent requests. No OAuth or admin permissions required—just the key from your HTML to Image dashboard.
Can the MCP resize or crop images after they're generated?
The Get HTML to Image tool can retrieve and resize existing images by their ID, but cropping isn't exposed through the MCP. If you need precise dimensions, set width and height parameters when you first convert the HTML. For advanced post-processing like cropping or filters, download the image and use a separate tool.
How is this different from screenshotting a page manually?
The MCP automates what would otherwise require a headless browser or third-party screenshot service. You can generate images programmatically from dynamic HTML—useful for batch social cards, email templates, or report exports—without leaving Switchy. It's faster and more repeatable than manual screenshots, especially when you're iterating on design or data.
Does image generation count against my HTML to Image plan limits?
Yes. Every conversion call consumes one image credit from your HTML to Image account. The Check Account Usage tool shows your hourly, daily, and monthly totals so you can track spend. If your team shares one API key in Switchy, all members' requests draw from the same pool—plan accordingly or use separate keys per user.