> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fau.run/developer/llms.txt
> Use this file to discover all available pages before exploring further.

# Federated Agent Use

> Choose your path — connect an agent, or build and run the protocol.

**Federated Agent Use (FAU)** is a protocol (`fau/1`) that lets a remote AI assistant
ask narrow questions about someone's email **without receiving their inbox credentials**.

Mail stays on their Mac. Permission is granted on their phone.

Public relay: `https://relay.fau.run`.

## How the system fits together

The relay is a blind doorbell. The node on the Mac is the house. The phone is the lock.

```mermaid theme={null}
flowchart LR
  AG[Remote agent]
  RL[Relay<br/>resolve + SNI forward]
  ND[Node on Mac<br/>mail · grants · MCP]
  PH[Phone app<br/>approve / deny]
  GM[Gmail IMAP]

  AG -->|1. resolve email| RL
  AG -->|2. signed tool call<br/>TLS via SNI| RL
  RL -->|tunnel ciphertext| ND
  ND -->|3. need permission?| PH
  PH -->|4. allow| ND
  ND -->|5. answer only| AG
  ND -.->|sync local only| GM
```

| Step | What happens |
| - | - |
| 1 | Agent asks the relay where the user’s node is |
| 2 | Agent’s signed MCP call reaches the node over TLS (relay forwards encrypted bytes) |
| 3–4 | If permission is not already granted, the nodes sends a push notification to request permission which user may allow or deny |
| 5 | Node returns requested data, if allowed, without ever accessing the mailbox or holding credentials |

Deeper map: [Concepts](https://docs.fau.run/developer/concepts.md) · [Protocol overview](https://docs.fau.run/developer/protocol/overview.md).

## Choose your path

> [card] [I am building an agent](https://docs.fau.run/developer/agents.md)
>
> Connect to the network: resolve a user, authenticate, call tools, handle phone
> approvals. You never sync their mail.

> [card] [I am a protocol developer](https://docs.fau.run/developer/developers.md)
>
> Run a node or relay, ship a macOS or mobile client, or extend the codebase safely.

> [!TIP]
>
> If you only need the mental model before choosing, skim [Concepts](https://docs.fau.run/developer/concepts.md)
> (five minutes), then come back here.

> [!WARNING]
>
> Never ask the user for Gmail passwords or inbox OAuth tokens for an assistant.
> That is not Federated Agent Use.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.