Documentation Index
Fetch the complete documentation index at: https://docs.rippit.com/llms.txt
Use this file to discover all available pages before exploring further.
How authentication works
The Rippit MCP server is an OAuth 2.1 Protected Resource (RFC 9728). Your client bounces you toapp.rippit.com in a browser window, you sign in there, and your client receives a short-lived JWT audience-bound to this MCP server (RFC 8707).
You only ever enter your Rippit credentials in the browser. The MCP server and your agent never see them. Supported clients refresh tokens automatically; if a token cannot be refreshed, you will be prompted to sign in again.
Security and access control
Token scope
The MCP server acts as the signed-in user. It can read and write only what that user could read and write directly inapp.rippit.com. There is no service account, no admin scope, and no way for the MCP server to bypass Rippit’s existing workspace permissions or role assignments. Revoking a user’s access in Rippit revokes their MCP access on the next token refresh.
Read / write surface
| Capability | Effect |
|---|---|
| Workbook and worksheet access | Read-only for existing objects. New objects are written through Ask Rippit. |
| Ask Rippit (start and continue an analysis) | Creates an Ask Rippit conversation in the user’s workspace and appends questions to it. These show up in the user’s history at app.rippit.com like any other. |
Hostnames
For allowlisting, the client touches three origins:| Origin | Purpose | Direction |
|---|---|---|
mcp.rippit.com | MCP endpoint; all JSON-RPC traffic | Client → Rippit (HTTPS) |
app.rippit.com | OAuth authorization server; user sign-in | Browser → Rippit (HTTPS) |
cdn.rippit.com | Static assets loaded by the Ask Rippit card | Client iframe → Rippit (HTTPS) |
Card sandbox
Ask Rippit cards render inside your MCP client’s standard sandboxed iframe. The card’s only outbound network capabilities are JSON-RPC calls back tomcp.rippit.com (proxied through the host) and static asset loads from cdn.rippit.com.