RecordHTML MCP server
Commit Nov 4, 2026Records web pages and HTML5 creatives to MP4, WebM, or GIF formats using a real browser.
Also known as recordHTML/mcp, mcp
- Stars
- 0
- Tools
- 5
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 4, 2026
- License
- MIT
What is RecordHTML MCP?
RecordHTML records web pages and HTML5 creatives to MP4, WebM, or GIF formats using a real browser. It exposes 5 tools, such as record_html, get_recording, estimate_recording.
Summary generated from the project's README
About RecordHTML MCP server
Converting web pages and HTML5 creative assets into video files is what RecordHTML enables for developers using AI assistants. This hosted MCP server uses a real browser to capture animations, banners, ads, and landing pages, outputting them as MP4, WebM, or GIF formats. Because the server is hosted remotely, there is no local installation required, and it works via streamable HTTP.
Users connect through clients like Claude Desktop, Cursor, or the Gemini CLI by providing a specific URL. Authentication is handled through OAuth sign-in or by providing an API key for headless agents. The server provides five specific tools: record_html for capturing URLs or documents, get_recording to check status, estimate_recording to check usage and limits, list_recordings to view history, and delete_recording to remove files. It operates using the same storage and limits as the official web application.
What you can do with it
- 1Convert landing pages to videoAsk your AI assistant to record a specific public URL as an MP4 file with custom dimensions and duration.
- 2Animate and capture HTML5 bannersHave an AI write HTML5 code for a banner and immediately record it as a GIF.
- 3Manage recording resourcesCheck your current usage and estimated costs before starting a new recording task.
Written from the project's README. Every use case is checked against a quote from it.
How to install RecordHTML MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall RecordHTML MCP in Claude Code
$ claude mcp add --transport http mcp https://mcp.recordhtml.com/Install RecordHTML MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.recordhtml.com/"
}
}
}Install RecordHTML MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.recordhtml.com/"
}
}
}Install RecordHTML MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.recordhtml.com/"}'Install RecordHTML MCP in Codex
$ codex mcp add mcp --url https://mcp.recordhtml.com/Install RecordHTML MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.recordhtml.com/"
Install RecordHTML MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.recordhtml.com/Install RecordHTML MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.recordhtml.com/",
"type": "http"
}
}
}RecordHTML MCP tools 5
Detected from the READMErecord_htmlget_recordingestimate_recordinglist_recordingsdelete_recording
| record_html | — | |
| get_recording | — | |
| estimate_recording | — | |
| list_recordings | — | |
| delete_recording | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablerecordhtml/mcp is public and reachablegithub.com/recordhtml/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-04github.com/recordhtml/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubRecordHTML MCP server
Connect RecordHTML to an AI assistant and ask it for videos. The hosted MCP server records web pages and HTML5 creatives (banners, ads, animations, landing pages) to MP4, WebM or GIF in a real browser. It uses the same recorder, limits and storage as the web app and the API.
https://mcp.recordhtml.com
Streamable HTTP, sign in with OAuth. There is nothing to install or run on your machine.
This repository holds the server's listing in the MCP Registry (
com.recordhtml/mcp), the Cursor plugin and the Gemini CLI extension. The server itself is hosted and not open source; the files in this repository are MIT-licensed. Full documentation: https://recordhtml.com/docs/mcp
Connect
Add a remote MCP server with the URL above. Your client opens a sign-in page: sign in or create an account, approve the access and go back to the client. It should then list five tools.
Claude Code: then type /mcp, choose recordhtml and sign in.
claude mcp add --transport http recordhtml https://mcp.recordhtml.com
Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, with
https://mcp.recordhtml.com as the URL, then Connect.
Cursor (~/.cursor/mcp.json, or install the plugin in this repository):
{
"mcpServers": {
"recordhtml": { "url": "https://mcp.recordhtml.com" }
}
}
Gemini CLI: install the extension, start gemini and sign in when the browser opens (or run
/mcp auth recordhtml).
gemini extensions install https://github.com/recordHTML/mcp
VS Code (.vscode/mcp.json):
{
"servers": {
"recordhtml": { "type": "http", "url": "https://mcp.recordhtml.com" }
}
}
ChatGPT, Codex and other clients: see Set up your client.
With an API key
Headless agents, and clients that can set headers, can send an API key from the API settings page instead of signing in. Keys are refused from browser pages.
claude mcp add --transport http recordhtml https://mcp.recordhtml.com \
--header "Authorization: Bearer $RECORDHTML_API_KEY"
Tools
| Tool | What it does |
|---|---|
record_html |
Record a public URL, or an HTML document the assistant wrote, to a video. Waits for the result and returns a signed video link. |
get_recording |
A recording's status, report and a fresh video link; can wait for one that is still running. |
estimate_recording |
Check a request without recording or using up quota: what to fix, the estimate, your limits and usage. |
list_recordings |
Your recordings, newest first. |
delete_recording |
Delete a recording's video files for good. |
Example prompts:
- Record https://recordhtml.com at 1280×720 for 5 seconds as an MP4.
- Write a 300×250 HTML5 banner that fades in the headline "Summer Sale" and a "Shop now" button, then record it as a 6 second GIF.
Privacy and support
- Privacy policy: https://recordhtml.com/privacy (what the MCP server receives is covered under "AI assistants and the MCP server").
- Terms: https://recordhtml.com/terms
- Support: hello@recordhtml.com or https://recordhtml.com/contact
What is in this repository
| File | Used by |
|---|---|
server.json |
The MCP Registry listing (com.recordhtml/mcp) |
.cursor-plugin/plugin.json, mcp.json, assets/ |
The Cursor plugin |
gemini-extension.json, GEMINI.md |
The Gemini CLI extension (gemini extensions install https://github.com/recordHTML/mcp) |
Publishing (maintainers)
MCP Registry
The server is published under the com.recordhtml namespace, proven by a DNS TXT record at the
apex of recordhtml.com. You need mcp-publisher
and OpenSSL 3 (macOS's built-in LibreSSL has no Ed25519).
One time: create a key and add its TXT record.
OPENSSL=/opt/homebrew/opt/openssl@3/bin/openssl
$OPENSSL genpkey -algorithm Ed25519 -out key.pem # keep it secret; *.pem is git-ignored
echo "recordhtml.com. IN TXT \"v=MCPv1; k=ed25519; p=$($OPENSSL pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)\""
Add that record at the apex (recordhtml.com, not a subdomain), next to the existing TXT
records. When you rotate the key, remove the old record.
Each release:
mcp-publisher validate
mcp-publisher login dns --domain recordhtml.com \
--private-key "$($OPENSSL pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"
mcp-publisher publish
curl -s "https://registry.modelcontextprotocol.io/v0.1/servers?search=com.recordhtml/mcp"
version follows the server's own version (MCP_SERVER_VERSION in html-recorder-web). To
republish with only metadata changes, use a prerelease such as 1.0.0-1. A version can't be
published twice.
Gemini CLI extension and Cursor plugin
Keep version in gemini-extension.json and .cursor-plugin/plugin.json in step, and tag each
release (git tag v1.0.0 && git push --tags, or a GitHub release with the same tag). The Gemini
gallery indexes this repository through its gemini-cli-extension topic. Cursor reviews every
plugin update before it reaches the Marketplace.
RecordHTML MCP questions
How do I add RecordHTML MCP to Claude Code?
Run claude mcp add --transport http mcp https://mcp.recordhtml.com/ in your terminal. Add --scope user to make it available in every project.
How do I add RecordHTML MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does RecordHTML MCP provide?
It exposes 5 tools, including record_html, get_recording, estimate_recording, list_recordings, delete_recording.
What can I record with RecordHTML?
You can record public URLs or HTML documents written by an assistant, including HTML5 creatives like banners, ads, animations, and landing pages.
Do I need to install anything on my computer?
No, the server is hosted and there is nothing to install or run on your local machine.
How can I use an API key instead of signing in?
Headless agents or clients that support custom headers can use an API key from your API settings page.
Can I check the cost or quota before recording?
Yes, you can use the estimate_recording tool to check a request without using up your quota.