Letterby Docs

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.

ScopeShown asLets the client
offers:readRead offersRead publications, offers, spend and conversion totals.
agreements:readRead agreementsRead the offers your publications promote and each agreement's status.
payouts:readRead payoutsRead payouts and their per-offer lines.
balance:readRead balanceRead your balance, reserved and available amounts.
subscribers:readRead subscriber countsReserved. No tool uses it yet.
webhooks:readRead webhook configReserved. 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

ProtectionDetail
Sign-inOAuth 2.1 with PKCE. The client never sees your Letterby sign-in.
ConfirmationApproving a client asks you to confirm it's you with an authenticator or email code.
Short-lived tokensAccess tokens last 10 minutes. Refresh tokens last 30 days and are replaced on every use.
Stolen token detectionIf a used refresh token is presented again, every token from that approval is revoked.
StorageLetterby stores only a hash of each token.
Live checksEvery 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 injectionText 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.

On this page