# faist

> faist gives your agent a SQL window into your inbox. Connect Fastmail once, then any MCP-capable client (Claude, Cursor, Continue, Cline, VSCode native MCP) can search, group, and aggregate every email you've ever received. Hybrid lexical (pgroonga BM25) + semantic (pgvector) search, indexed into a Postgres database you own.

## Docs

- [User documentation](https://faisty.com/docs): sign-in, indexing, plans, key minting, per-client connector recipes, tool reference, example queries
- [User documentation (raw markdown)](https://faisty.com/docs.md): same content as text/markdown, paste-friendly for agents

## Product

- [Landing](https://faisty.com/): what faist is, how it differs from Fastmail's official MCP server, sign-in entry point
- [Fastmail MCP vs. faist comparison](https://faisty.com/compare/fastmail-mcp-vs-faist): side-by-side of the official Fastmail MCP and faist — live ops vs. historical SQL index
- [Dashboard](https://faisty.com/dashboard): per-user MCP keys, paired clients, indexing status, plan
- [Workbench](https://faisty.com/workbench): in-app SQL playground with natural-language presets

## Blog

- [SQL over your Fastmail inbox — and why we built faist](https://faisty.com/blog/sql-over-your-fastmail-inbox): Fastmail shipped an MCP server. faist is the SQL layer on top: full historical index in your own Supabase, hybrid lexical + semantic search, every email ever, queryable from Claude.

## Source

- [GitHub repository](https://github.com/adek05/faist): source code, architecture and threat-model docs
- [Architecture](https://github.com/adek05/faist/blob/main/docs/architecture.md): JMAP → Supabase pipeline design
- [Threat model](https://github.com/adek05/faist/blob/main/docs/threat-model.md): security analysis

## MCP

- Endpoint: `POST https://faisty.com/mcp` (Streamable HTTP)
- Auth: `Authorization: Bearer faist_pat_…` minted from the dashboard's MCP cell
- Tools: `schema` (introspect jmap.* tables), `sql-query` (run a SELECT, format csv|jsonl|markdown), `query` (NL preview, keyword-routed presets)