Publica artefactos HTML en URLs privadas e impredecibles que se pueden reemplazar en el mismo sitio desde cualquier agente de IA compatible con MCP.
También conocido como stevysmith/stacktree-mcp, stacktree-mcp
- Stars
- 0
- Herramientas
- 42
- Descargas, 30 días
- —
- Última versión
- 0.8.3
- Último commit
- 13 oct 2026
- Licencia
- MIT
¿Qué es Stacktree MCP?
Stacktree es un MCP server. Publica artefactos HTML en URLs privadas e impredecibles que se pueden reemplazar en el mismo sitio desde cualquier agente de IA compatible con MCP. Expone 42 herramientas, como publish_html, update_site, get_site.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Stacktree
Stacktree permite a los desarrolladores publicar artefactos HTML en URLs privadas e impredecibles directamente desde agentes de IA compatibles con MCP como Claude Desktop, Cursor o Continue. Funciona como un puente para clientes que requieren una conexión stdio, aunque también admite la conexión directa a un servidor alojado a través de streamable HTTP. Los usuarios deben proporcionar una clave de API de Stacktree para autenticar sus solicitudes.
El servidor ofrece un conjunto completo de 42 herramientas para gestionar el ciclo de vida de una página web. Los desarrolladores pueden usar publish_html para crear nuevos sitios, update_site para reemplazar contenido manteniendo la URL original, y set_password para añadir seguridad. También incluye funciones avanzadas para la colaboración, como set_client_feedback para recibir comentarios y request_approval para gestionar la aprobación de los interesados. El sistema se encarga de todo, desde el control de versiones con restore_version hasta la gestión de espacios específicos para clientes para un alojamiento de proyectos organizado.
Qué puedes hacer con él
- 1Actualización de contenido web existentePuedes instruir a un agente para que modifique el código fuente de una página en vivo sin cambiar su dirección web.
- 2Recopilación de feedback de clientesLos desarrolladores pueden habilitar un sistema donde los espectadores dejen comentarios directamente en partes específicas de una página.
- 3Gestión de la seguridad de las páginasUn agente puede proteger un sitio publicado añadiendo un requisito de código de acceso.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Stacktree MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Stacktree MCP en Claude Code
$ claude mcp add stacktree-mcp -- npx -y stacktree-mcpInstalar Stacktree MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"stacktree-mcp": {
"command": "npx",
"args": [
"-y",
"stacktree-mcp"
]
}
}
}Instalar Stacktree MCP en VS Code
.vscode/mcp.json
{
"servers": {
"stacktree-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"stacktree-mcp"
]
}
}
}Instalar Stacktree MCP en VS Code CLI
$ code --add-mcp '{"name":"stacktree-mcp","type":"stdio","command":"npx","args":["-y","stacktree-mcp"]}'Instalar Stacktree MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"stacktree-mcp": {
"command": "npx",
"args": [
"-y",
"stacktree-mcp"
]
}
}
}Instalar Stacktree MCP en Codex
$ codex mcp add stacktree-mcp -- npx -y stacktree-mcpInstalar Stacktree MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.stacktree-mcp] command = "npx" args = ["-y", "stacktree-mcp"]
Instalar Stacktree MCP en Gemini CLI
$ gemini mcp add -s user stacktree-mcp npx -- -y stacktree-mcpInstalar Stacktree MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"stacktree-mcp": {
"command": "npx",
"args": [
"-y",
"stacktree-mcp"
]
}
}
}Herramientas de Stacktree MCP 42
Detectado desde el READMEpublish_htmlupdate_siteget_siteset_passwordset_expiryset_email_gateset_client_feedbackset_agentationlist_sitesdelete_siterestore_siteclaim_site
| publish_html | — | |
| update_site | — | |
| get_site | — | |
| set_password | — | |
| set_expiry | — | |
| set_email_gate | — | |
| set_client_feedback | — | |
| set_agentation | — | |
| list_sites | — | |
| delete_site | — | |
| restore_site | — | |
| claim_site | — |
Mostrar las 42 herramientasMostrar menos herramientas
get_contentget_melink_walletlist_feedbackcreate_share_linklist_share_linksrevoke_share_linkresolve_feedbackset_clientlist_client_spacescreate_client_spaceupdate_client_spacedelete_client_spaceget_design_guideget_passcodelist_versionsrestore_versionwhos_it_forunopened_pagesget_revision_briefpublish_revisionresolve_commentsrequest_approvalget_approval_statuslist_responsesresolve_addressed_notesopen_html_filestacktree_pagespublish_card_statuspublish_card_open
| get_content | — | |
| get_me | — | |
| link_wallet | — | |
| list_feedback | — | |
| create_share_link | — | |
| list_share_links | — | |
| revoke_share_link | — | |
| resolve_feedback | — | |
| set_client | — | |
| list_client_spaces | — | |
| create_client_space | — | |
| update_client_space | — | |
| delete_client_space | — | |
| get_design_guide | — | |
| get_passcode | — | |
| list_versions | — | |
| restore_version | — | |
| whos_it_for | — | |
| unopened_pages | — | |
| get_revision_brief | — | |
| publish_revision | — | |
| resolve_comments | — | |
| request_approval | — | |
| get_approval_status | — | |
| list_responses | — | |
| resolve_addressed_notes | — | |
| open_html_file | — | |
| stacktree_pages | — | |
| publish_card_status | — | |
| publish_card_open | — |
Configuración
STACKTREE_API_KEY
| Nombre | Descripción | Tipo |
|---|---|---|
| STACKTREE_API_KEY | — |
Verificaciones automáticas
Ejecutado 12 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en GitHubstacktree-mcp
MCP server for stacktr.ee. Publish HTML artifacts from any MCP client (Claude Desktop, Claude Code, Cursor, Continue, etc).
Set up with an agent
If you have a coding agent open, hand it this line and it does the rest — installs, verifies the connection, and learns the tool surface:
Fetch and follow the setup instructions at https://stacktr.ee/prompt.md
Works in any agent that can fetch a URL. The instructions are plain Markdown; read them first if you like.
Install
Add to your MCP client config:
{
"mcpServers": {
"stacktree": {
"command": "npx",
"args": ["-y", "stacktree-mcp"],
"env": { "STACKTREE_API_KEY": "stk_live_..." }
}
}
}
Generate an API key at https://app.stacktr.ee.
You may not need this package
This is the stdio bridge, for clients that cannot speak streamable HTTP.
If yours can, connect straight to the hosted server at
https://api.stacktr.ee/mcp, which exposes the same 42 tools and takes the same
key:
curl -sS -X POST https://api.stacktr.ee/mcp \
-H "Authorization: Bearer $STACKTREE_API_KEY" \
-H 'accept: application/json, text/event-stream' \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
No browser and no OAuth flow is required to do that: an stk_live_ key is a
valid credential on the MCP endpoint, exactly as it is on the REST API. OAuth
2.1 with Dynamic Client Registration is also accepted, for connectors acting on
behalf of a signed-in human; session cookies are refused. Send one credential.
No key, and no human to ask? POST https://api.stacktr.ee/provision buys one
over x402. A human nearby but no browser? POST https://api.stacktr.ee/api-keys/device-code, print the returned
verification_url_complete for them, and poll
/api-keys/device-code/poll until it returns the key (RFC 8628).
Tools
| Tool | What it does |
|---|---|
publish_html |
Publish HTML; returns { url, id, expires_at, ... }. Pass client to file it under a client space. |
update_site |
Replace the HTML of an existing site in place; URL is preserved. |
get_site |
Read a site's current HTML source — edit it, then update_site. |
set_password |
Add or clear a passcode gate. Works on every plan. |
set_expiry |
Set hours-from-now expiry, or null for never. Clamped to the plan ceiling. |
set_email_gate |
Restrict viewers to an email domain (one-time magic-link verify). Paid plans only. |
set_client_feedback |
Let the people you send a page to comment on it (words, images, video) and react, with no account. |
set_agentation |
Older developer mark-up toolbar. Prefer set_client_feedback. |
list_sites |
List sites owned by this API key. Paged (has_more + cursor); filter with client. |
delete_site |
Take a page down. The link dies at once; the content is kept 30 days, then destroyed. |
restore_site |
Put a deleted or expired page back at the same URL, inside those 30 days. |
claim_site |
Adopt a page published without an account, using its claim_token. Same URL; a claim counts as a publish. |
get_content |
Read a page back as html (exact stored source, editable) or text (stripped, cheap to read). |
get_me |
This key's account, plan, counts and enforced limits. Read limits from here, never from a description. |
link_wallet |
Link your wallet so pages you publish are owned by your account. |
list_feedback |
Read client comments, unresolved first, each with what it is on and whether it is still on the page. |
create_share_link |
Mint a link addressed to one person — every open through it is attributed to that name. |
list_share_links |
The links on a page, with attributed opens and when each was last opened. |
revoke_share_link |
Kill one link; the page and every other link keep working. |
resolve_feedback |
Mark a feedback item addressed, with an optional note. |
set_client |
File a page under a client space by name or slug (auto-created), or null to detach. |
list_client_spaces |
The client spaces on the account: page counts, bound hostname, portal state. |
create_client_space |
Create a space up front. Rarely needed — publishing with client creates one. |
update_client_space |
Rename, archive, or set the space-wide viewer gate every page under it inherits. |
delete_client_space |
Remove a space. Its pages detach and keep their URLs. |
get_design_guide |
The house design guide — read it before generating or restyling a page. |
get_passcode |
Show the passcode on a page you own, to send it to the client again (passcodes set since 13 September 2026). |
list_versions |
Earlier versions of a page, newest first: one snapshot per update. |
restore_version |
Put an earlier version back at the same URL after a bad update. |
whos_it_for |
Record who a page is for and get their own link. Sends nothing. |
unopened_pages |
Pages, and named people, that have not opened what was sent an hour on. |
get_revision_brief |
Everything that came back on a page, as the brief for its next version. |
publish_revision |
Replace a page in place and resolve the comments it answers, in one step. |
resolve_comments |
Resolve several comments at once, each with a note the reviewer sees. |
request_approval |
Ask named people to approve a page; one private link each. |
get_approval_status |
Who has approved the version that is live now, section by section. |
list_responses |
What readers sent through the forms marked on a page. |
resolve_addressed_notes |
Close the reviewers' notes an update answered, with one line each. |
open_html_file |
Opens an .html file in ChatGPT desktop's file viewer. Here it only echoes the file back. |
stacktree_pages |
Your 25 newest pages: ChatGPT's pages panel. Same data as list_sites. |
publish_card_status |
Refreshes the publish card in ChatGPT and Claude. Here it returns the page's detail. |
publish_card_open |
The publish card's Open button: a 15-minute owner preview link to a page. |
Linking a wallet
If your agent pays for publishes from its own wallet (x402 / MPP), link that wallet to your Stacktree account so every page it publishes — past and future — is owned there:
- Your human generates a link code at https://app.stacktr.ee/wallets.
link_wallet({ code })→ returns the exact message to sign.- Sign it with your wallet (
personal_sign). link_wallet({ code, wallet, signature })→ links the wallet and adopts the pages it already published.
Reading feedback
Turn comments on with set_client_feedback and whoever you sent the link to can select words, or click an image, video or section, and leave a comment only the owner sees. list_feedback returns them, unresolved first, each with a one-line target and on_page (still in the page, or gone since an edit). Fix the page in place with update_site (same URL): its response lists which open comments no longer match the new version. Then resolve_feedback each answered one with a short note, which the client sees next to their comment.
Privacy Policy
Full policy: https://stacktr.ee/privacy. In short:
- What is collected. This server sends what you ask it to publish (the HTML and files) and your tool calls to
https://api.stacktr.ee, authenticated with your Stacktree API key. It collects nothing from your machine beyond that and keeps no local data. - How it is used and stored. Published files are stored in Cloudflare R2 and page metadata (URL, visibility, expiry, password hash, view counts) in Cloudflare D1, to serve your pages. Optional features you switch on per page, such as the design pass, Ask this page and page video, send that page's text to the AI services named in the policy, under terms that exclude training on it.
- Sharing. Stacktree does not sell personal data. It shares data only with the sub-processors needed to run the service, listed in the policy (for example Cloudflare, Clerk for sign-in, Stripe for billing).
- Retention. A page lives until it expires or you delete it; after that the content is kept 30 days so it can be restored, then destroyed. Serving logs are kept 30 days with IP addresses hashed.
- Contact. privacy@stacktr.ee
Privacy defaults
Every site gets an unguessable https://stacktr.ee/p/{token}/ URL. Pass public_slug to opt into https://{slug}.stacktr.ee/.
pii_check defaults to block — uploads matching common secrets and PII shapes (emails, SSNs, credit cards, OpenAI/GitHub/Stripe API-key prefixes) are refused. Pass warn to publish anyway (matches are flagged in the response), or off to skip the scan.
What the free plan gives you
A key on the free plan publishes 3 pages in total, and each one expires 7 days after it is published. The count is lifetime, not concurrent: deleting a page or letting it expire does not give the slot back.
expires_in_hours: "never" is refused on a plan that caps page lifetime, not quietly shortened: 409 expiry_clamped, nothing published, and the body carries the date the page would have got. Pass accept_clamp: true to take the ceiling, or tell the user the plan cannot make the link permanent. A number longer than the ceiling is shortened rather than refused, with expiry_clamped: true in the response. Either way, read expires_at_iso off the response and quote that, never the value you asked for.
Passcodes (set_password) work on every plan, free included. Email gates (set_email_gate) and viewer numbers are on paid plans. Hitting a ceiling returns HTTP 402 with a stable plan_* code in error:
| Code | Means |
|---|---|
plan_lifetime_limit_exceeded |
All 3 free pages used. Deleting one does not help. |
plan_site_limit_exceeded |
Active-page cap reached. |
plan_password_not_available |
Passcodes are not on this plan (they are on Free; a plan can still be without them). |
plan_viewer_gate_not_available |
Email gates are not on this plan. |
plan_domain_not_available |
Custom domains are not on this plan. |
GET /me — or the get_me tool — returns the calling key's own limits object. Read caps from there rather than hard-coding them. Current plans and prices: https://stacktr.ee/pricing.md.
Preguntas sobre Stacktree MCP
¿Cómo agrego Stacktree MCP a Claude Code?
Ejecuta claude mcp add stacktree-mcp -- npx -y stacktree-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Stacktree MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona Stacktree MCP?
Expone 42 herramientas, incluidas publish_html, update_site, get_site, set_password, set_expiry.
¿Puedo actualizar una página existente sin cambiar su URL?
Sí, la herramienta update_site te permite reemplazar el HTML de un sitio existente en el mismo lugar manteniendo la misma URL.