Gel

You run this MCP server to access Gel data tooling from your coding agents. It provides query execution, safe transactional queries, and quick access to Gel code examples and rules, helping you automate and streamline Gel-related workflows.

How to use

You use an MCP client to connect to the Gel MCP server you installed. Once connected, you can run queries against the Gel instance, execute code examples, and fetch rules and workflows to enhance your AI extensions. The tools are designed for practical workflows such as querying data, testing changes in a transaction, and browsing ready-to-use examples and rules.

How to install

Prerequisites: ensure you have a supported runtime and MCP client tooling installed on your development workstation. The Gel MCP server configuration relies on a local MCP runtime command that you invoke from your editor or terminal.

Step 1: Add the MCP server configuration to your editor or MCP setup. Use the following configuration snippet to register the Gel MCP server under a suitable alias.

{
  "mcpServers": {
    "gel": {
      "command": "uvx",
      "args": [
        "--refresh",
        "--python",
        "3.13",
        "--directory",
        ".",
        "--from",
        "git+https://github.com/geldata/gel-mcp.git",
        "gel-mcp"
      ]
    }
  }
}

Additional configuration and setup notes

You can enable Gel support in various editors by adding identical MCP server snippets to your environment. For Cursor, Claude Code, VSCode with Copilot, Windsurf, and Zed, you’ll consistently register the Gel MCP server with the same command and arguments as shown above.

Available tools

execute_query

Run a query against the Gel instance configured in the current project. Supports arguments and globals.

try_query

Run a query in a transaction that gets rolled back in the end, preventing actual data modification.

list_examples

Access code examples for advanced workflows such as configuring the AI extension.

fetch_example

Fetch a specific code example for use in your workflows.

list_rules

List available Gel rules in case you forgot to configure them in your text editor.

fetch_rule

Fetch a specific Gel rule for use in your editor or workflow.