Fastmail Search
O faist espelha sua caixa de entrada do Fastmail no seu próprio Supabase e a expõe ao Claude e outros clientes MCP como SQL. Com busca híbrida lexical e semântica.
Documentação
FAIST · faist.dev SEÇÃO 01 · ABERTO 0%
02 / 06 · o índice
sua caixa de entrada, como um banco de dados que pensa.
cada mensagem vira uma linha. cada linha carrega um vetor de embedding para busca por similaridade. tudo em tempo real, tudo em postgres.
paula@blackmtn.law nov 12
re: renovação de contrato d3 — contraproposta
Conforme nossa ligação, aceitaríamos um prazo de 36 meses se o reajuste permanecer em…
billing@vercel.com nov 12
sua fatura está pronta · $214,00
Oi Sam, sua fatura do plano Pro de outubro está anexada…
jess@anthropic.com nov 11
re: integração claude · pode enviar
Vamos fechar os bindings MCP na segunda. Vou revisar seu PR hoje à noite…
noreply@stripe.com nov 11
pagamento · $2.184,22 enviado
Seus fundos estão a caminho. Chegada prevista: 13 de novembro.
events@yc.com nov 10
horário de atendimento de outubro · resumo
Doze fundadores, seis tópicos. O deck e as anotações estão linkados abaixo…
k@mom.net nov 10
ação de graças?
você vai dirigir para cá ou quer que eu desça este ano. — k
ƒ
ÍNDICE
mensagens — postgres · seu projeto 8 tabelas · 1 ƒ ext
| # | de | assunto | enviado | embedding(1536) |
|---|---|---|---|---|
| 1 | paula@blackmtn.law | re: renovação de contrato d3 — contraproposta | 2d | |
| 2 | billing@vercel.com | sua fatura está pronta · $214,00 | 2d | |
| 3 | jess@anthropic.com | re: integração claude · pode enviar | 3d | |
| 4 | noreply@stripe.com | pagamento · $2.184,22 enviado | 3d | |
| 5 | events@yc.com | horário de atendimento de outubro · resumo | 4d | |
| 6 | k@mom.net | ação de graças? | 4d |
03 / 06 · duas interfaces
linguagem natural para humanos. SQL para agentes.
as mesmas linhas, duas superfícies. faça uma pergunta em inglês e o faist traduz. ou pule a tradução: qualquer agente que fale SQL ou MCP pode ler sua caixa de entrada sem nunca tocar em suas credenciais do fastmail.
— 01 / para humanos linguagem natural
"qual é aquela coisa de contrato que a paula enviou?"
digite a pergunta. o faist a incorpora, executa a busca por similaridade e responde com o resultado — citações incluídas.
qual é aquela coisa de contrato que a paula enviou na semana passada — preciso da cláusula de contraproposta
Encontrei — Paula Mendez, Black Mountain Law, 12 de nov · "re: renovação de contrato d3 — contraproposta". A contraproposta é um prazo de 36 meses com reajuste anual de 2,5%. Quer que eu puxe a conversa ou rascunhe uma resposta?
mostre o SQL
— 02 / para agentes SQL · MCP · webhook
um banco de dados que qualquer agente pode ler.
claude, cursor, openwebui — além de seus próprios scripts. um token read-only do fastmail entra. linhas estruturadas saem. agentes nunca veem suas credenciais.
-- claude · servidor MCP · 127.0.0.1:7474
-- ferramenta: query(sql)
select "from", subject, sent_at
from messages
where embedding <-> embed('paula lease counter') < 0.32
order by sent_at desc limit 5;
paula@blackmtn.law re: renovação de contrato d3 — contraproposta 2d
paula@blackmtn.law re: renovação de contrato d2 6d
docusign-noreply documento concluído 6d
(3 linhas ·84 ms· provedor=zero-retention)
linguagem natural · para humanos
servidor MCP · OAuth2
webhook em nova linha
apenas postgres · psql ok
04 / 06 · tempo real
nova mensagem chega. uma linha aparece. esse é o ciclo.
o faist mantém um stream JMAP ao vivo com o fastmail. mensagens, conversas, rótulos, anexos — eles chegam ao seu banco de dados em menos de um segundo após atingirem sua caixa de entrada. nada para agendar, nada para atualizar.
indexado paula@blackmtn.law re: renovação de contrato d3 — contraproposta · agora indexado k@mom.net ação de graças? · agora indexado billing@vercel.com sua fatura está pronta · $214,00 · agora indexado jess@anthropic.com re: integração claude · pode enviar · agora indexado noreply@stripe.com pagamento · $2.184,22 enviado · agora indexado events@yc.com horário de atendimento de outubro · resumo · agora indexado security@1password novo login do macOS · agora indexado nora@figma.com compartilhou "faist · rascunho da landing" · agora indexado notion-team resumo semanal · 12 páginas · agora indexado noreply@github.com PR #128 pronto para revisão · agora indexado paula@blackmtn.law re: renovação de contrato d3 — contraproposta · agora indexado k@mom.net ação de graças? · agora indexado billing@vercel.com sua fatura está pronta · $214,00 · agora indexado jess@anthropic.com re: integração claude · pode enviar · agora indexado noreply@stripe.com pagamento · $2.184,22 enviado · agora indexado events@yc.com horário de atendimento de outubro · resumo · agora indexado security@1password novo login do macOS · agora indexado nora@figma.com compartilhou "faist · rascunho da landing" · agora indexado notion-team resumo semanal · 12 páginas · agora indexado noreply@github.com PR #128 pronto para revisão · agora
05 / 06 · preços
comece grátis. vá para ilimitado quando crescer.
ambos os planos rodam no seu projeto supabase — a diferença é o que cobramos para manter o pipeline aberto. cancele quando quiser. pg_dump leva o resto com você.
Grátis
$0 /mês
espaço suficiente para conectar sua caixa de entrada, provar que funciona e deixar um ou dois agentes lerem seu e-mail.
- 5.000 e-mails de backfill do fastmail
- atualizações ao vivo limitadas — stream best-effort
- consultas limitadas por dia em NL + SQL
- servidor MCP · login OAuth2
- apenas postgres · pg_dump e vá
mais escolhido
Pro
$3 /mês
tudo ilimitado. para seu arquivo completo e os agentes que você realmente usa no dia a dia.
- backfill ilimitado — todo o seu histórico do fastmail
- atualizações ao vivo ilimitadas · stream JMAP em sub-segundo
- consultas ilimitadas — NL, SQL, MCP, webhooks
- servidor MCP · login OAuth2
- suporte prioritário · assistência de migração self-host
preços em USD. custos do projeto supabase (tipicamente $0–$25/mês) são pagos diretamente ao supabase. não há plano hospedado pelo faist — seus dados nunca vivem em nossos servidores.
06 / 06 · as promessas
três coisas que nunca pediremos de você.
— 01
seus dados vivem no seu banco de dados.
o faist grava em um projeto supabase que você possui. nosso backend é stateless: sem caixa de correio espelho, sem rehospedagem. se você excluir o projeto, os dados desaparecem — nunca tivemos uma segunda cópia.
projeto supabase · 8 tabelas · segurança em nível de linha ativada
— 02
embeddings fluem por endpoints zero-retention. nenhum corpo de mensagem, nenhum metadado, nada é usado para treinar um modelo. quando um modelo termina uma solicitação, o provedor não tem nada para lembrar.
provedor de embedding · zero-retention · sem opt-in de treinamento
— 03
sem vendor lock. migre a qualquer momento.
é apenas postgres. o schema é documentado e licenciado sob MIT. aponte um pg_dump para ele e vá embora — cada linha, cada embedding, cada relação. nos descarte; seus dados permanecem.
pg_dump $DATABASE_URL > faist.sql
07 · as perguntas
perguntas comuns.
O que é o faist?
o faist é um serviço TypeScript que ingere e-mail de qualquer provedor JMAP (Fastmail, Stalwart, genérico) em um banco de dados Postgres que você possui, e então o expõe a agentes de IA como SQL — via um endpoint REST ou um servidor MCP (Model Context Protocol) para Claude, Cursor, Continue e Cline.
Como o faist é diferente do servidor MCP oficial do Fastmail?
O MCP do Fastmail expõe operações ao vivo da caixa de entrada como ferramentas (ler, buscar, rascunhar). o faist constrói um índice histórico completo de cada mensagem no seu próprio Supabase, com busca híbrida lexical (pgroonga BM25) e semântica (pgvector), e o apresenta ao seu agente como SQL puro para que ele possa agregar, agrupar e unir anos de e-mail.
Onde meus dados de e-mail vivem?
No seu próprio projeto Supabase. o faist instala um schema jmap com escopo e uma função Postgres dedicada jmap_indexer; sua chave de service-role nunca é persistida pelo faist. Se você excluir o projeto Supabase, os dados desaparecem.
Quais clientes MCP o faist suporta?
Qualquer cliente MCP que fale Streamable HTTP — incluindo Claude Code (CLI e extensão VSCode), o MCP nativo do VSCode, Cursor, Continue, Cline e o MCP Inspector. A autenticação usa OAuth 2.1 com registro dinâmico de cliente, ou um PAT por usuário emitido pelo dashboard.
O faist funciona com provedores diferentes do Fastmail?
Sim. o faist fala com qualquer provedor JMAP — Fastmail, Stalwart ou qualquer servidor JMAP genérico — então a mesma superfície SQL funciona independentemente de quem hospeda seu e-mail.