Skip to main content
Ryft MCP is currently in Private Preview. To get early access, contact your Ryft representative.
Ryft MCP is a Model Context Protocol server that enriches your AI agents with full lakehouse context, including table metadata, query history, and domain knowledge - so they can write accurate queries and answer business questions without guessing.

​
Prerequisites

​
Setup

1. Add MCP configurationAdd Ryft MCP to Cursor2. ConnectClick Install in the prompt that appears, then click Connect. A browser window will open for you to log in with your Ryft credentials. After authenticating, you can close the browser tab and return to Cursor.
Add the following to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global access):
{
  "mcpServers": {
    "ryft": {
      "type": "http",
      "url": "https://app.ryft.io/mcp"
    }
  }
}
Then open Cursor Settings (Cmd/Ctrl + Shift + J) > Tools & MCP > find Ryft > Enable > Connect. A browser window will open for you to log in with your Ryft credentials.

​
Verify

To confirm everything is working, ask your AI tool any question about your lakehouse, for example:
“Search for tables related to orders”
If the connection is set up correctly, the assistant will use the search_tables tool and return results from your lakehouse.

​
Troubleshooting

Your AI tool will prompt you to re-authenticate via your browser. Follow the prompts to log in again.
  • Verify your network can reach app.ryft.io. Check if your organization requires a VPN.
  • For Claude: go to Settings > Connectors and check that Ryft is enabled
  • For Claude Code: run /mcp to check server status
  • For Cursor: open Cursor Settings (Cmd/Ctrl + Shift + J) > Tools & MCP to check server status
Restart your AI tool after adding the MCP configuration. For Claude Code, run /mcp to reconnect.