temp.md

Publique sites, aplicativos e documentos feitos por agentes em uma URL pública estável que é atualizada no lugar.

Documentação

`@tempmd/mcp`

Servidor MCP para temp.md — dê aos artefatos criados por agentes um link público estável que é atualizado no lugar.

Publique um artefato HTML, Markdown, CSV ou Mermaid e obtenha uma URL canônica como amber-hill-9eb6.temp.md. Envie novas versões por trás da mesma URL — sem precisar compartilhar novamente, nunca. Os Temps expiram intencionalmente quando o trabalho esfria (janela ativa de 7 dias, reinicia a cada atualização) e podem ser restaurados dentro de 7 dias após a expiração.

Instalação

Remoto — sem instalação

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

O MCP remoto aceita arquivos UTF-8 inline ou base64. A publicação anônima não exige credencial. Para publicar diretamente em uma conta e usar ferramentas da conta, configure a conexão com Authorization: Bearer <tempmd_key_...>.

Stdio local — melhor para acesso ao sistema de arquivos e diretórios maiores

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

Cursor / Windsurf / qualquer cliente MCP — adicione à sua configuração MCP:

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

tempmd-mcp permanece disponível como pacote de compatibilidade com a mesma implementação e versão.

Nenhuma conta ou chave de API é necessária — temp.md é anônimo, cria primeiro. Reivindique um Temp depois para mantê-lo.

O transporte remoto é limitado a 10 MiB e 20 arquivos inline por pacote. O pacote stdio usa caminhos locais e suporta o pacote completo de 50 MiB / 100 arquivos.

Ferramentas

Ferramenta	Stdio local	Remoto	O que faz
`publish_temp`	✓	✓	Publica um novo artefato e obtém uma URL pública estável
`update_temp`	✓	✓	Envia uma nova versão por trás da mesma URL
`get_temp_status`	✓	✓	Verifica o ciclo de vida e a elegibilidade para restauração
`restore_temp`	✓	✓	Traz um Temp recentemente expirado de volta na mesma URL
`snapshot_temp`	✓	✓	Congela a versão atual como referência fixa
`set_comments`	✓	✓	Alterna comentários fixados de visitantes
`list_temps`	✓	✓	Lista registros locais do projeto ou Temps de propriedade da conta
`recover_update_token`	—	✓	Rotaciona e recupera um token de atualização com escopo perdido

publish_temp e update_temp aceitam spa_mode: true para aplicativos de página única roteados pelo cliente. Deixe desativado para sites estáticos para que ativos ausentes retornem 404. Os uploads são limitados a 10 MB por arquivo, 50 MB por pacote e 100 arquivos; os limites de publicação e atualização são 60/hora/IP e 120/hora/Temp/IP, respectivamente.

Como funcionam as credenciais

publish_temp salva um registro (ID do Temp, URL, token de atualização, expiração) em um arquivo .tempmd na raiz do projeto. Todas as outras ferramentas leem esse arquivo automaticamente, para que um agente possa atualizar o mesmo Temp entre sessões sem que você gerencie tokens. Os tokens também podem ser passados explicitamente via update_token.

Adicione .tempmd ao .gitignore se o token de atualização não deve ser compartilhado com todos que podem ler o repositório.

Configuração

Variável de ambiente	Padrão	Finalidade
`TEMPMD_API_URL`	`https://api.temp.md`	Apontar para uma API diferente (ex.: dev local `http://localhost:8787`)

Desenvolvimento

Este repositório espelha o pacote packages/mcp do monorepo temp.md, onde o desenvolvimento acontece. Issues e solicitações de recursos são bem-vindas aqui.

Semânticas que os agentes devem preservar

A URL canônica é o único link a compartilhar — nunca exiba links específicos de versão.
Uma atualização com falha nunca quebra o link ativo; a última versão bem-sucedida continua servindo.
Prefira update_temp em vez de publish_temp quando o projeto já tiver um Temp para o artefato.