temp.md

@tempmd/mcp

Servidor MCP para temp.md: brinda a los artefactos creados por agentes un enlace público estable que se actualiza en el mismo lugar.

Publica un artefacto HTML, Markdown, CSV o Mermaid y obtén una URL canónica como amber-hill-9eb6.temp.md. Empuja nuevas versiones detrás de la misma URL, sin necesidad de volver a compartir, nunca. Los Temps expiran intencionalmente cuando el trabajo se enfría (ventana activa de 7 días, se reinicia con cada actualización) y pueden restaurarse dentro de los 7 días posteriores a la expiración.

Instalación

Remoto — sin instalación

claude mcp add --transport http tempmd https://api.temp.md/mcp

El MCP remoto acepta archivos UTF-8 en línea o base64. La publicación anónima no requiere credenciales. Para publicar directamente en una cuenta y usar herramientas de cuenta, configura la conexión con Authorization: Bearer <tempmd_key_...>.

Stdio local — ideal para acceso al sistema de archivos y directorios más grandes

claude mcp add tempmd -- npx -y @tempmd/mcp

Cursor / Windsurf / cualquier cliente MCP — agrégalo a tu configuración de MCP:

{
  "mcpServers": {
    "tempmd": {
      "command": "npx",
      "args": ["-y", "@tempmd/mcp"]
    }
  }
}

tempmd-mcp sigue disponible como paquete de compatibilidad con la misma implementación y versión.

No se requiere cuenta ni clave API: temp.md es anónimo, se crea primero. Reclama un Temp más tarde para conservarlo.

El transporte remoto está limitado a 10 MiB y 20 archivos en línea por lote. El paquete stdio usa rutas locales y admite el lote completo de 50 MiB / 100 archivos.

Herramientas

Herramienta	Stdio local	Remoto	Qué hace
publish_temp	✓	✓	Publica un nuevo artefacto y obtén una URL pública estable
update_temp	✓	✓	Empuja una nueva versión detrás de la misma URL
get_temp_status	✓	✓	Verifica el ciclo de vida y la elegibilidad de restauración
restore_temp	✓	✓	Trae de vuelta un Temp recientemente expirado a la misma URL
snapshot_temp	✓	✓	Congela la versión actual como referencia fija
set_comments	✓	✓	Alterna comentarios de visitantes fijados
list_temps	✓	✓	Lista registros de proyectos locales o Temps propiedad de la cuenta
recover_update_token	—	✓	Rota y recupera un token de actualización con alcance perdido

publish_temp y update_temp aceptan spa_mode: true para aplicaciones de una sola página enrutadas por el cliente. Déjalo desactivado para sitios estáticos para que los recursos faltantes devuelvan 404. Las cargas están limitadas a 10 MB por archivo, 50 MB por lote y 100 archivos; los límites de publicación y actualización son 60/hora/IP y 120/hora/Temp/IP respectivamente.

Cómo funcionan las credenciales

publish_temp guarda un registro (ID de Temp, URL, token de actualización, expiración) en un archivo .tempmd en la raíz del proyecto. Cada otra herramienta lee ese archivo automáticamente, para que un agente pueda actualizar el mismo Temp entre sesiones sin que gestiones tokens. Los tokens también pueden pasarse explícitamente mediante update_token.

Agrega .tempmd a .gitignore si el token de actualización no debe compartirse con todos los que puedan leer el repositorio.

Configuración

Variable de entorno	Predeterminado	Propósito
TEMPMD_API_URL	https://api.temp.md	Apunta a una API diferente (por ejemplo, http://localhost:8787 de desarrollo local)

Desarrollo

Este repositorio refleja el paquete packages/mcp del monorepo temp.md, donde ocurre el desarrollo. Los problemas y solicitudes de funciones son bienvenidos aquí.

Semántica que los agentes deben preservar

• La URL canónica es el único enlace para compartir: nunca muestres enlaces específicos de versión.
• Una actualización fallida nunca rompe el enlace en vivo; la última versión exitosa sigue sirviendo.
• Prefiere update_temp sobre publish_temp cuando el proyecto ya tenga un Temp para el artefacto.