How do I use Gel MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Gel MCP Server show me the top 5 users by activity this week" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Gel MCP Server

by geldata

Overview Schema Source Related Servers Discussions Admin

Python

Local

Gel MCP server

This MCP server provides tools and resources that help coding agents use the Gel database.

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 and fetch_example: access code examples for advanced workflows such as configuring the AI extension.
list_rules and fetch_rule: in case you forgot to configure Gel rules in your text editor, the agent can access them like this, too.

Related MCP server: @iadev/mcp-server

Install

If at any point you get lost, refer to this repository to see an example config layout for your editor.

Cursor

Add the following to .cursor/mcp.json:

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

Open MCP settings, e.g. via Command Palette: View: Open MCP Settings and toggle Gel in there.

Claude Code

Add the following to .mcp.json:

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

VSCode with Copilot

Add the following to .vscode/mcp.json:

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

Windsurf

Follow Windsurf Cascade's documentation to open global mcp_config.json via the clicky interface. Add the following:

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

Zed

Add the following to .zed/settings.json:

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

Develop

Clone the repository and create the virtual environment:

uv sync

Open the server in the MCP Inspector:

mcp dev src/gel_mcp/server.py

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessUnresponsive

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

mcp-serverOAuth
com.make
Give your AI agents the tools to build, manage, and run automation workflows.
App Automation Developer Tools Workplace & Productivity
2
nuzur-mcp-serverOAuth
io.github.mklfarha
AI agents propose database changes as reviewable requests — no direct write access.
Databases Developer Tools Autonomous Agents
2
ateam-mcp AOAuth
io.github.ariekogan
Build, validate, and deploy multi-agent AI solutions from any AI environment.
Agent Orchestration Autonomous Agents Developer Tools
21
MeroFoundryOAuth
com.merofoundry
Build and publish full-stack apps from your coding agent: models, rules, pages, auth, per-app MCP.
Coding Agents Developer Tools
1

Related MCP Servers

TextQL MCP Server
Search Databases
alexandme
A
license
Not graded
quality
D
maintenance
Translates natural language to SQL/GraphQL queries and executes them, enabling AI agents to interact with databases through the Model Context Protocol.
Updated a year ago (2025-07-24 22:16 UTC)
1
Apache 2.0
@iadev/mcp-server
Databases Developer Tools Cloud Platforms
iadevhub
F
license
B
quality
D
maintenance
Enables AI assistants to directly manage database tables, execute SQL, and handle user operations in iadev projects from the editor.
Updated 5 months ago (2026-04-07 14:20 UTC)
15
-
SQL Server MCP Server
Claritas-LLC
F
license
Not graded
quality
D
maintenance
Enables AI agents to inspect schemas, analyze performance, check security, and troubleshoot SQL Server 2019+ databases through a safe, controlled interface.
Updated 7 months ago (2026-02-12 12:38 UTC)
-
SQL Server MCP Server
Databases Developer Tools
dkp5897
A
license
A
quality
B
maintenance
Enables AI agents to interact with SQL Server databases for debugging and data issue resolution, providing tools for query execution, schema inspection, and diagnostics.
Updated a month ago (2026-08-08 06:42 UTC)
13
10 npm
MIT