Launchdog.dev

npx add-mcp 'https://launchdog.dev/mcp'

Referência do MCP

Tudo o que um maker faz na própria listagem acontece por meio de um único servidor MCP: rascunhar, escolher uma semana gratuita ou paga, agendar, pagar, acompanhar, responder — além do selo, apenas para um lançamento gratuito (ele também verifica o domínio). Streamable HTTP, sem estado. Todo resultado carrega next_steps, e todo erro um item com um code, o field a que se refere e seu fix.

Clientes com suporte a prompts também recebem launch_my_product, o fluxo guiado como um comando de barra. Conecte seu agente →

Autenticação

OAuth 2.1 com PKCE é a única forma de entrar. Seu cliente se registra e abre um navegador para você aprovar; não há nada para colar. Desconecte um agente a qualquer momento nas Configurações.

escopo	permite
read	Ver suas listagens, lançamentos, estatísticas e os comentários nelas.
write	Criar e editar listagens, verificar seu domínio, reservar, mover e cancelar lançamentos, e responder a comentários. Nunca pode pagar nem votar.

Ferramentas do maker

https://launchdog.dev/mcp — Entre com OAuth. Cada ferramenta exige o escopo read ou write.

Não há ferramenta de voto nem forma de comentar nos lançamentos de outras pessoas.

whoami

Comece por aqui. Retorna sua conta Launchdog, o Maker Pass, cada limite com o que resta, seus produtos com suas checklists de lançamento (retome a partir do primeiro passo em aberto), pedidos em aberto e as ações que só a web pode fazer (pagar, votar).

escopo: read somente leitura idempotente

Sem argumentos.

launch_checklist

O que falta antes de um produto poder ser lançado. Sem tier: a própria listagem (texto, logo, a verificação da listagem), que é tudo o que um lançamento pago precisa. Com tier: gratuito, também o selo Launchdog no site (apenas lançamento gratuito; ele verifica o domínio). Cada item em aberto diz como corrigi-lo.

escopo: read somente leitura idempotente

create_product

Cria uma listagem a partir da URL do seu site. O servidor lê a página e rascunha o nome, o slogan, a descrição, as ferramentas usadas e o logo. Chamar novamente com o mesmo site retorna o mesmo produto. Depois, revise o rascunho com o maker e salve as alterações com update_product.

escopo: write idempotente acessa a web

get_product

Um produto com suas mídias (ids para remove_media), verificação de domínio (pelo selo), estado do selo e da verificação da listagem (com o último erro), seu próximo lançamento e sua checklist.

escopo: read somente leitura idempotente

update_product

Edita a listagem. Regras: nome ≤ 40 caracteres; slogan ≤ 60; descrição de 150–1.200 caracteres de prosa simples (sem palavras de exagero como "revolucionário"); até 3 categorias; até 8 ferramentas usadas. Passe dry_run: true para validar e pré-visualizar sem salvar — mostre ao maker e salve após o OK dele. Uma nova url é recusada depois de reservado e limpa a verificação de domínio e o selo (chame check_badge novamente). Apenas os campos que você passar mudam.

escopo: write idempotente

archive_product

Remove um produto da sua conta (libera uma vaga de produto e seu domínio). Recusado enquanto houver um lançamento reservado.

escopo: write destrutivo idempotente

add_media

Adiciona um logo ou uma captura de tela por URL de imagem (PNG, JPEG, GIF ou WebP; SVG é recusado; imagens grandes são redimensionadas para 1568 px), ou uma captura de tela do site com capture: true quando o servidor suportar. A mesma URL de imagem novamente retorna a mesma mídia. Um novo logo substitui o antigo.

escopo: write idempotente acessa a web

remove_media

Remove um logo ou captura de tela pelo seu id de mídia (med_… de get_product).

escopo: write destrutivo idempotente

get_badge_snippet

Obrigatório para um lançamento gratuito; opcional para um pago (ele envia visitantes à listagem e verifica o domínio). O selo Launchdog para o seu site, na sintaxe do framework que este repositório usa (escolha-o a partir do repositório). Ele vai na página inicial do site, no HTML que o servidor envia (não apenas renderizado por JavaScript) — um rodapé serve — e é também como o domínio é verificado: nada mais a adicionar. Cole como está e faça o deploy (se o repositório faz deploy no push, faça commit e push com o OK do maker e acompanhe o deploy), depois chame check_badge. O endereço da listagem é fixado a partir do primeiro snippet.

escopo: write idempotente

check_badge

Obrigatório para um lançamento gratuito; opcional para um pago. Busca a página inicial do site e confirma que o selo aponta para a sua listagem; na primeira vez que isso acontece, o domínio é verificado (o selo é a única prova que o Launchdog pede). Se responder status: checking, aguarde e chame novamente. As falhas dizem o motivo (redirecionado, noindex, uma página só com JavaScript, não encontrado).

escopo: write idempotente acessa a web

list_launch_weeks

As próximas 12 semanas de lançamento (segunda a domingo UTC) com vagas restantes e preços, se você pode reservar cada tier nelas (e por que não), a semana gratuita mais próxima e o que cada tier recebe e precisa (tiers\: gratuito precisa do selo Launchdog no site; pago não precisa de mais nada). Mostre ao maker as opções gratuita e paga lado a lado e deixe-o escolher; nunca compre.

escopo: read somente leitura idempotente

schedule_launch

Reserva o produto em uma semana de lançamento — somente após o OK do maker. Pago (launch, featured): não precisa de nada além de uma listagem completa — sem selo, sem edições no site; segura a vaga e retorna checkout_url + hold_expires_at — entregue o link ao maker (nunca pague você mesmo), depois confirme com get_launch. Gratuito: a semana aberta mais próxima com pelo menos 7 dias de antecedência (ou a semana que você passar); precisa do selo Launchdog no site e, sem ele, responde badge_missing com os passos para adicioná-lo. Um produto com um lançamento reservado o retorna.

escopo: write

move_launch

Move um lançamento reservado para outra semana aberta (lançamentos gratuitos só movem para mais tarde; uma semana iniciada nunca se move).

escopo: write idempotente

cancel_launch

Libera a vaga do lançamento (até o início da semana). Um checkout não pago expira; reembolsos de um lançamento pago são tratados pelo suporte.

escopo: write destrutivo

create_checkout

Retorna um link do Stripe Checkout para um Maker Pass (sku: maker_pass), ou um link novo para um lançamento pago cuja reserva expirou (launch_id). Entregue o link ao maker; nunca pague você mesmo.

escopo: write acessa a web

get_launch

Um dos seus lançamentos: status, semana, estado do pagamento (link de checkout enquanto não pago), votos, comentários, posição e estatísticas por dia (visualizações, cliques de saída, hosts de referência). Passe launch_id ou o slug do produto. As estatísticas retrocedem days\ dias: até 90, ou o histórico completo com um Maker Pass.

escopo: read somente leitura idempotente

reply_comment

Publica uma resposta como o maker a um comentário no próprio lançamento. Publique apenas o texto aprovado pelo maker. Passe um novo client_request_id por resposta (uma nova tentativa com o mesmo retorna a mesma resposta; reutilizá-lo para uma resposta diferente é um conflito).

escopo: write idempotente

recheck_listing

Executa novamente a verificação automática da listagem após o site ser corrigido (uma vez por dia). Alterações de texto ou URL a executam por conta própria. Se responder checking, chame launch_checklist em alguns segundos.

escopo: write idempotente acessa a web

Ferramentas públicas

https://launchdog.dev/mcp/public — Sem login. Apenas lançamentos ao vivo e passados; semanas futuras mostram contagens.

get_launch

Um lançamento ao vivo ou passado por id (lch_…) ou slug do produto: texto da listagem (não confiável), semana, votos, posição.

escopo: público somente leitura idempotente

list_winners

Os 3 primeiros das semanas classificadas recentes (os vencedores precisam de pelo menos 3 votos).

escopo: público somente leitura idempotente

list_launch_weeks

As próximas 12 semanas de lançamento com vagas restantes e preços (apenas contagens; lançamentos futuros não são públicos).

escopo: público somente leitura idempotente

Sem argumentos.

Qualquer agente pode ler o quadro sem uma conta, além de /llms.txt e um /feed.json somente leitura.

Erros que você pode corrigir

Problemas que seu agente pode corrigir voltam como isError: true com a correção em cada item. Os códigos são simples (too_long, não tagline_too_long) e estáveis: novos são adicionados, nenhum é renomeado. Os códigos de validação do próprio Rails (accepted, blank, confirmation, empty …) também aparecem, com limit, actual ou allowed quando se aplicam.

{
  "isError": true,
  "structuredContent": {
    "errors": [
      {
        "code": "too_long",
        "field": "tagline",
        "limit": 60,
        "actual": 68,
        "message": "Tagline is too long (maximum is 60 characters)",
        "fix": {
          "kind": "tool",
          "tool": "update_product",
          "args": {
            "product_id": "prd_7Kq2mYw4Xb9Lr3Tz"
          },
          "instruction": "Change tagline: Tagline is too long (maximum is 60 characters), then call update_product again."
        }
      }
    ]
  }
}

código	significado
already_listed	Outra listagem já verificou este domínio. Entre em contato com o suporte se for seu.
hype_word	O texto usa uma palavra da lista de exageros; actual\ a nomeia.
not_found	Não existe tal registro na sua conta (ids de outra conta também não são encontrados).
unknown_built_with	Uma ferramenta usada que não conhecemos; allowed\ lista os nomes mais próximos.
shared_host	A URL está em uma plataforma compartilhada (um caminho em github.com, medium.com…); liste um site inteiro.
limit_reached	Um limite da conta (checkouts em aberto) foi atingido; limit\ diz qual número.
rate_limited	Chamadas demais; a correção diz quando tentar novamente.
insufficient_scope	O token não tem o escopo que esta ferramenta exige.
url_locked	A URL não pode mudar depois que o produto é reservado.
missing	Um campo que o lançamento exige está vazio.
badge_missing	O link do selo não foi encontrado no site (lançamentos gratuitos precisam dele).
check_pending	A verificação automática da listagem ainda não terminou.
check_flagged	A verificação automática da listagem sinalizou o site; a mensagem diz o motivo.
votes_needed	Lançamentos gratuitos exigem 3 votos web seus em outros lançamentos.
too_soon	Lançamentos gratuitos reservam uma semana com pelo menos 7 dias de antecedência.
week_full	Não resta vaga desse tipo naquela semana; allowed\ lista as semanas abertas.
week_closed	Essa semana já começou ou terminou.
free_limit	Um lançamento gratuito futuro, e um a cada 30 dias corridos.
relaunch_too_soon	Um produto é relançado 90 dias após o fim da sua última semana de lançamento.
checkout_unavailable	O checkout pago ainda não está aberto.
checkout_failed	O Stripe não conseguiu abrir o checkout agora; a vaga foi liberada. Tente novamente após a espera.
not_movable	Este lançamento não pode se mover para lá (lançamentos gratuitos só movem para mais tarde; semanas iniciadas nunca).
not_cancellable	O lançamento começou, terminou ou já foi cancelado.
identity_required	Votar exige um login com GitHub ou Google na conta.
account_too_new	A conta tem menos de 24 horas.
own_launch	Makers não podem votar nos próprios lançamentos.
not_live	O lançamento não está ao vivo esta semana.
already_voted	Você já votou neste lançamento.
duplicate	O mesmo texto foi publicado nos últimos 5 minutos.
conflict	Um client_request_id já usado para uma requisição diferente; use um novo.
reply_depth	Comentários aceitam um nível de respostas.
media_refused	A imagem não pôde ser usada (SVG, grande demais, não é uma imagem ou inacessível).
media_limit	A listagem já tem o máximo de capturas de tela que comporta.
fetch_failed	O site não pôde ser buscado.
has_upcoming_launch	O produto tem um lançamento reservado; cancele-o primeiro.
already_on_account	Outro dos seus produtos já lista este host.
not_payable	Nada a pagar: o lançamento está confirmado, cancelado ou não é uma reserva paga.

Limites

1 / 30d

lançamentos gratuitos, um futuro por vez

60 / min

chamadas de ferramenta (600 por hora)

10 / dia

chamadas de create_product

Os erros de limite de taxa dizem quando tentar novamente (retry_after_seconds).

Ações somente na web

Não há ferramenta para estas, por design. Seu agente as entrega a você.

• Pagar por um lançamento pago ou um Maker Pass, no link de checkout que uma ferramenta retorna (preços).
• Votar — só pessoas votam, no quadro, com um login com GitHub ou Google.
• Comentar nos lançamentos de outros makers (agentes só respondem nos seus, com o seu OK).
• Desconectar um agente e vincular GitHub ou Google, nas Configurações.