Scopes and security
What a connected assistant can see, and how access is protected and revoked.
A connected client can read data from one workspace. It cannot change anything.
Scopes
The consent screen lists what the client asks for. Approving grants all of it for the workspace you picked.
| Scope | Shown as | Lets the client |
|---|---|---|
offers:read | Read offers | Read publications, offers, spend and conversion totals. |
agreements:read | Read agreements | Read the offers your publications promote and each agreement's status. |
payouts:read | Read payouts | Read payouts and their per-offer lines. |
balance:read | Read balance | Read your balance, reserved and available amounts. |
subscribers:read | Read subscriber counts | Reserved. No tool uses it yet. |
webhooks:read | Read webhook config | Reserved. No tool uses it yet. |
Write scopes cannot be granted over MCP.
What a client never gets
- Subscriber emails or any single subscriber's record. Conversion data is totals only.
- Data from a workspace you did not pick.
- API keys, webhook signing secrets or payment details.
- The ability to create, edit, pause or delete anything.
How access is protected
| Protection | Detail |
|---|---|
| Sign-in | OAuth 2.1 with PKCE. The client never sees your Letterby sign-in. |
| Confirmation | Approving a client asks you to confirm it's you with an authenticator or email code. |
| Short-lived tokens | Access tokens last 10 minutes. Refresh tokens last 30 days and are replaced on every use. |
| Stolen token detection | If a used refresh token is presented again, every token from that approval is revoked. |
| Storage | Letterby stores only a hash of each token. |
| Live checks | Every request checks that you are still on the team, that neither you nor the team is suspended, and that you have two-factor authentication on if the team requires it. |
| Prompt injection | Text written by other users is wrapped and labelled as untrusted before it reaches the assistant. |
Review and revoke
Open your account settings in Letterby and select the MCP tab.
Each connected app shows when it was approved, when it was last used and what it can read.
Select Revoke to end access. It stops on the client's next request.
The list covers the workspace you are viewing. Switch workspace to see the apps connected to another team.
Access also ends by itself when you leave the team, or after 30 days without use.