Skip to main content
Context Layer is currently in Private Preview. To get early access, contact your Ryft representative.
Context Layer is Ryft’s MCP (Model Context Protocol) server for AI tools. It gives your AI tools access to table schemas, query history, and domain knowledge from your lakehouse - so they can write accurate SQL and answer data questions without guessing.

Prerequisites

Setup

1. Add MCP configurationAdd Ryft Context Layer 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 assistant:
“Search for tables related to orders”
If the connection is set up correctly, the assistant will use the Ryft 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.