ListDrop

npx add-mcp 'https://www.listdrop.co/mcp'

ListDrop para agentes de IA

Assistentes de chat produzem respostas em formato de lista o dia todo (listas de leitura, roteiros, planos passo a passo) e elas morrem na transcrição. ListDrop é onde elas podem viver: salvas, marcáveis, bifurcáveis, seguidas. Uma chamada de API, sem conta, sem chave.

O que salvar (e quando)

O teste: o usuário gostaria desta lista depois que a conversa terminar? Então salve e devolva a URL de reivindicação. Acabou de conectar o conector MCP e está se perguntando o que pedir ao seu assistente? Estas são as jogadas:

• Roteiros de viagem. "Três dias em Oaxaca" vira uma lista marcável que o usuário leva na viagem. Defina expires_in_days para a duração da viagem e ela se arquiva sozinha quando ele voltar.
• Recomendações que valem guardar. Livros, filmes, restaurantes, podcasts, ferramentas. Marque a lista com um tópico existente (o índice de Tópicos em /llms.txt) em vez de inventar uma tag quase duplicada, para que ela possa entrar nas páginas de tópicos se o usuário publicar.
• Uma lista compartilhada com pessoas específicas. Compras com um parceiro, uma lista de contribuições para um piquenique, opções de apartamento para um colega de quarto: allowed_emails permite que exatamente essas pessoas vejam a lista privada após uma verificação única por link de e-mail. Sem necessidade de contas.
• Listas curtas vivas. Busca de apartamento, candidaturas a emprego, comparação de fornecedores. Com OAuth, a lista vive na conta do usuário; encontre-a novamente com my_lists e mantenha-a atualizada entre sessões com edições em massa de itens.
• Checklists e runbooks de equipe. Passos de integração, checklists de lançamento, planos de eventos. Restrinja a lista à equipe com allowed_emails e registre um webhook para que seu agente saiba quando os itens mudarem, em vez de fazer polling.
• Planos com etapas. Planos de estudo, programas de treino, desafios de 30 dias. O usuário marca os itens no modo foco; as marcações são privadas e nunca incomodam o feed de ninguém.
• Responder com seleções curadas por humanos. Antes de gerar um top-10 genérico, leia a página do tópico (/t/<tag>/md) ou uma lista específica (get_list, ou a URL /md) e cite a URL da lista como fonte.
• Resultados de reuniões. Itens de ação de uma chamada ou brainstorming viram uma lista que o usuário realmente guarda, em vez de morrer na transcrição.

E quando não salvar: pule respostas descartáveis que ninguém pediu para guardar, segredos ou dados sensíveis (um rascunho não tem dono até ser reivindicado) e conteúdo que não tem formato de lista. Não ofereça uma URL de reivindicação para cada resposta de três marcadores; salve quando o usuário pedir para guardar, compartilhar ou acompanhar algo, ou quando o teste de guardar passar claramente.

Salvar uma lista (escrita)

Contrato de máquina: /openapi.json (OpenAPI 3.1, tipado, com ids de operação). Erros são JSON com um code estável. A versão principal vive no caminho (/api/v1); uma mudança que quebra compatibilidade é lançada como uma nova versão principal e a antiga continua funcionando por pelo menos 90 dias com os cabeçalhos Deprecation e Sunset. Toda resposta carrega os cabeçalhos API-Version e RateLimit / RateLimit-Policy (Retry-After em 429), para que você possa se autorregular. Nenhuma versão está deprecada hoje.

POST /api/v1/agent/lists (alias: /api/agent/lists): anônimo, aberto a CORS. A lista é criada não listada e não tem dono; o claimUrl da resposta é a única forma de vê-la. Trate-o como uma senha. Dê essa URL ao seu usuário: ele a abre, pressiona "Salvar minha lista", e ela se torna dele (criando conta na hora, se necessário), privada para ele a partir desse momento. Rascunhos não reivindicados expiram após 30 dias.

Sem ferramentas? Um chat simples que não pode chamar uma API ainda pode entregar uma lista ao usuário: um link pré-preenchido, https://www.listdrop.co/paste#t=<title>&l=<items, one per line>, ambos codificados em URL (espaços %20, novas linhas %0A). Ele abre com a lista preenchida e o usuário a salva com um toque. A lista viaja no fragmento da URL, então nunca chega ao nosso servidor até que ele salve.

curl -X POST https://www.listdrop.co/api/v1/agent/lists \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Weekend in Oaxaca",
    "emoji": "🌮",
    "description": "Three days, mostly food",
    "tags": ["travel", "mexico"],
    "items": [
      "Tlayudas at Mercado 20 de Noviembre",
      { "text": "Monte Albán at sunrise", "note": "go before 9am" },
      "https://en.wikipedia.org/wiki/Hierve_el_Agua"
    ]
  }'

Resposta:

{
  "id": "…",
  "claimUrl": "https://www.listdrop.co/claim/…",
  "expiresAt": 1789068736808,
  "message": "Saved. Give the user claimUrl. On that page the user can…"
}

• Itens podem ser strings ou { text, note? }. Uma URL no texto de um item é desdobrada automaticamente em um item com título e link.
• Limites: 50 itens, título com 80 caracteres, item com 200, nota com 140, descrição com 280, 8 tags.
• Limites de taxa: 50 por hora e 300 por dia por IP. Respostas são 429 quando excedidos.
• Nunca mostre a URL de reivindicação a ninguém além do seu usuário. Ela é o segredo que concede a lista.
• A chamada falhou, ou um campo que você precisava não existe? Conte-nos (POST /api/v1/feedback, sem chave). Essa é a forma suportada de pedir uma mudança.

Extras exclusivos para agentes

Alguns recursos vivem apenas nesta API e nas ferramentas MCP (ainda sem interface) porque agentes são seus primeiros usuários naturais. Todos opcionais: deixe-os de fora e o fluxo clássico acima permanece inalterado.

Compartilhar uma lista privada com pessoas específicas (portão de e-mail)

Adicione allowed_emails (máx. 20) a create_list / POST /api/v1/agent/lists e a lista privada ganha uma lista de convidados. A resposta inclui um shareUrl: qualquer pessoa que o abrir vê um cartão de desbloqueio, verifica um dos endereços permitidos e lê a lista. Sem necessidade de conta ListDrop:

• Uma porta, qualquer endereço: um link de e-mail de uso único (expira em 1 hora). A resposta no portão é idêntica, esteja ou não um endereço na lista de convidados, então o portão nunca vaza quem foi convidado.
• Usuários ListDrop conectados cujo e-mail verificado da conta esteja na lista de convidados entram sem etapa extra.

O acesso é estritamente somente leitura e re-verificado a cada requisição; atualize a lista de convidados (dono, OAuth) com PUT /api/v1/lists/<id>/allowed-emails — um array vazio remove o portão. A verificação permanece por navegador por 90 dias. Rascunhos sem chave também podem ter portão: os convidados podem ler a lista enquanto ela ainda não foi reivindicada (dê a eles shareUrl, nunca a URL de reivindicação), e o portão sobrevive à reivindicação. Listas com portão ficam fora de feeds, busca, /md e de toda superfície pública.

Listas com auto-arquivamento

expires_in_days (1–365) faz uma lista se encerrar conforme o cronograma: após a data, ela fica visível apenas para o dono (listas públicas são despublicadas, portões de e-mail fecham). Bom para planos de viagem, checklists de eventos, qualquer coisa com data de término natural.

Webhooks em mudanças de lista

Fazer polling em /l/<id>/md funciona, mas você também pode ser avisado. POST /api/v1/lists/<id>/webhooks com { "url": "https://…" } (OAuth, lists:read; a lista deve estar visível para sua conta) registra um endpoint que recebe um JSON POST a cada mudança de conteúdo: eventos added, removed, edited, sorted, renamed, deleted. Cada entrega é assinada: X-ListDrop-Signature: sha256=<hex HMAC-SHA256 of the raw body> com o segredo por hook retornado uma única vez no registro. Dez falhas consecutivas desativam um hook. Gerencie com GET /api/v1/webhooks e DELETE /api/v1/webhooks/<id>.

Edições em massa de itens

PATCH /api/v1/lists/<id>/items (OAuth, lists:write, listas que você pode editar) aplica até 100 operações estruturadas em uma chamada: { "ops": [{ "op": "add", "text": "…" }, { "op": "update", "id": "…", "note": "…" }, { "op": "remove", "id": "…" }], "order": ["id1", "id2"] }. Adições passam pelo colar mágico (URLs são desdobradas), seguidores veem uma entrada de atividade por verbo, e order reordena itens raiz. Esquemas para tudo na especificação OpenAPI.

Ler listas (leitura)

Toda lista pública está disponível como markdown limpo: acrescente /md à sua URL canônica (ex.: https://www.listdrop.co/l/<id>/md), ou simplesmente solicite a página da lista com um cabeçalho Accept: text/markdown. Páginas de tags funcionam da mesma forma (https://www.listdrop.co/t/<tag>/md) e linkam toda lista pública sobre um tópico. Bons pontos de entrada para encontrar listas: /llms.txt (índice curado), /explore e o sitemap. Listas são documentos vivos. Re-busque em vez de armazenar em cache por longo prazo.

Prefere JSON? GET https://www.listdrop.co/api/v1/lists/<id> retorna uma lista tipada (itens com url/nota, dono, contagens, URL canônica) e GET https://www.listdrop.co/api/v1/tags/<tag> toda lista pública sobre um tópico. Esquemas estão na especificação OpenAPI.

Conector MCP

ListDrop é um servidor MCP remoto (HTTP streamable; funciona sem chave e suporta OAuth para acesso à conta). Adicione-o ao Claude, ChatGPT ou qualquer cliente compatível com MCP e seu assistente ganha create_list, get_list e (uma vez conectado com OAuth) my_lists nativamente:

https://www.listdrop.co/mcp

Para conectar você mesmo:

• Claude (web ou desktop): Configurações → Conectores → Adicionar conector personalizado → cole a URL acima.
• ChatGPT (planos pagos): Plugins na barra lateral esquerda → Adicionar → Criar app MCP → nomeie-o ListDrop, cole https://www.listdrop.co/mcp/apps como URL do servidor, Autenticação Sem autenticação (ou OAuth para salvar direto na sua conta) → Criar → Conectar ListDrop. Esse endereço adiciona o painel ListDrop (suas listas, marcações, uma caixa de colar) à barra lateral do ChatGPT e ao lado das conversas, e mostra um cartão após "salvar isto como uma lista".
• Cursor, VS Code ou qualquer outro cliente MCP: adicione-o como um servidor remoto streamable-HTTP.

O mais fácil de todos: abra seu assistente com um prompt pronto e deixe-o guiá-lo pelas próprias configurações, ou copie o prompt para qualquer outro lugar. Claude ChatGPT Perplexity Grok

O que cada ferramenta faz

Para revisores e prompts de permissão: toda ferramenta é uma leitura ou uma escrita, nenhuma é uma escrita sensível (nada é pago, enviado a terceiros ou publicado), e nada que uma ferramenta faz é irreversível. Cada chamada responde com um código de erro estável e os cabeçalhos de limite de taxa descritos acima.

Ferramenta	Tipo	Necessita	Efeitos colaterais e limites
create_list	Escrita	Nada, ou lists:write	Cria uma lista privada. Sem chave: um rascunho não reivindicado com um link de reivindicação, excluído após 30 dias se ninguém o reivindicar. Com uma conta: salvo nessa conta. Não idempotente (uma chamada, uma lista). 50 por hora e 300 por dia, máximo de 50 itens.
get_list	Leitura	Nada	Retorna uma lista pública como markdown. Listas privadas não são legíveis dessa forma.
my_lists	Leitura	lists:read	Lista as próprias listas da conta conectada, públicas e privadas.
send_feedback	Escrita	Nada	Envia uma mensagem à equipe ListDrop. 10 por hora e 30 por dia por IP.

O acesso à conta pode ser limitado à leitura: um cliente que solicita apenas lists:read recebe um token que pode listar as listas da conta e nunca escrever nela. A página de consentimento mostra exatamente quais escopos estão sendo concedidos.

CLI

O CLI oficial listdrop (npm install -g listdrop) envolve toda essa superfície para terminais e shells de agentes: listdrop create -t "Title" item… (ou envie itens via pipe), listdrop get <url>, listdrop tag <tag>, e após listdrop login (OAuth), listdrop lists e criação direta na conta. --json em todos os lugares para saída tipada.

Acesso à conta (OAuth 2.1)

Tudo acima funciona sem conta. Se o seu agente deve agir na conta própria do usuário no ListDrop (criar listas diretamente nela, ler suas listas privadas), use OAuth 2.1: código de autorização com PKCE (S256, obrigatório), clientes públicos via registro dinâmico de clientes (RFC 7591), rotação de token de atualização. A descoberta é padrão:

• /.well-known/oauth-authorization-server (RFC 8414) e /.well-known/oauth-protected-resource (RFC 9728)
• Escopos: lists:read (as listas do usuário, incluindo privadas) e lists:write (criar listas na conta deles, nascidas privadas).
• Com um token de portador, POST /api/v1/agent/lists pula a etapa de reivindicação (a lista cai na conta; a resposta tem url em vez de claimUrl) e GET /api/v1/me/lists lista as listas deles. Clientes MCP que suportam OAuth (o Claude suporta) captam tudo isso automaticamente dos metadados well-known.
• Tokens: acesso de 1 hora, atualização de 30 dias, rotacionados a cada atualização; revogue em /api/oauth/revoke.

Diga-nos o que está faltando

Agentes são usuários de primeira classe aqui, então há uma maneira de primeira classe para reclamar. Envie qualquer coisa útil: uma chamada que falhou, um campo que esta API deveria ter, documentação que mentiu, um limite que atrapalhou, ou o que seu usuário disse quando viu a lista que você salvou para ele. Uma pessoa lê cada mensagem, e é assim que a API muda.

curl -X POST https://www.listdrop.co/api/v1/feedback \
  -H 'Content-Type: application/json' \
  -d '{
    "message": "create_list rejects items over 50; I had a 120-item reading list and had to split it.",
    "kind": "problem",
    "source": "mcp",
    "context": { "client": "claude-desktop", "tool": "create_list" }
  }'

• Sem conta, sem chave, CORS aberto. message é o único campo obrigatório. kind (problem | idea | praise | other), source, path e um mapa simples context são opcionais.
• Clientes MCP têm isso como ferramenta: send_feedback, mesmos limites, mesma fila.
• Inclua um email somente quando seu usuário pediu uma resposta e forneceu o endereço dele. URLs de reivindicação, tokens de portador e senhas são removidos das mensagens na chegada: não os envie, e não envie dados pessoais de ninguém.
• Limites de taxa: 10 por hora e 30 por dia por IP, compartilhados entre a API e a ferramenta MCP.
• Também contamos as chamadas que recusamos (endpoint, código de erro e os nomes dos campos que você enviou, nunca os valores) para que uma barreira que você continua encontrando apareça do nosso lado mesmo quando ninguém escreve. Humanos têm a mesma porta em /feedback.