timesfm
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Postgres gateway for AI agents: blocks destructive SQL, holds risky writes, undoes applied ones.
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…
scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 12/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Lomberk. Sigue https://mcp.popnx.com/i/ege-usta-lomberk.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Lomberk (créala en el sitio del autor) · 1 ajuste(s) que rellenar (LOMBERK_CONFIG) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Lomberk para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "lomberk": { "command": "uvx", "args": [ "lomberk", "serve" ], "env": { "LOMBERK_CONFIG": "your-value", "LOMBERK_AGENT_DSN": "your-value", "LOMBERK_ADMIN_DSN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En LOMBERK_AGENT_DSN, LOMBERK_ADMIN_DSN, LOMBERK_CONFIG deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Lomberk aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
LOMBERK_CONFIG Absolute path to the lomberk.yaml that `lomberk setup` wrote. The connection strings and keys are read from the .env beside it.Las descripciones siguen en el inglés original.
SettingsDeveloperEdit Config
{
"mcpServers": {
"lomberk": {
"command": "uvx",
"args": [
"lomberk",
"serve"
],
"env": {
"LOMBERK_CONFIG": "your-value",
"LOMBERK_AGENT_DSN": "your-value",
"LOMBERK_ADMIN_DSN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Lomberk y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Lomberk o muestra una herramienta de Lomberk en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Lomberk
Lomberk se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Lomberk
B · Otros en Bases de datos y conjuntos de datos que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Lomberk (créala en el sitio del autor) · 1 ajuste(s) que rellenar (LOMBERK_CONFIG) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Lomberk para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user lomberk --env LOMBERK_CONFIG=your-value --env LOMBERK_AGENT_DSN=your-value --env LOMBERK_ADMIN_DSN=your-value -- uvx lomberk serve 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En LOMBERK_AGENT_DSN, LOMBERK_ADMIN_DSN, LOMBERK_CONFIG deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Lomberk aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
LOMBERK_CONFIG Absolute path to the lomberk.yaml that `lomberk setup` wrote. The connection strings and keys are read from the .env beside it.Las descripciones siguen en el inglés original.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user lomberk --env LOMBERK_CONFIG=your-value --env LOMBERK_AGENT_DSN=your-value --env LOMBERK_ADMIN_DSN=your-value -- uvx lomberk serveCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Lomberk en la lista como conectado
Usa Lomberk y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Lomberk o muestra una herramienta de Lomberk en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Lomberk (créala en el sitio del autor) · 1 ajuste(s) que rellenar (LOMBERK_CONFIG) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Lomberk para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "lomberk": { "command": "uvx", "args": [ "lomberk", "serve" ], "env": { "LOMBERK_CONFIG": "your-value", "LOMBERK_AGENT_DSN": "your-value", "LOMBERK_ADMIN_DSN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En LOMBERK_AGENT_DSN, LOMBERK_ADMIN_DSN, LOMBERK_CONFIG deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Lomberk aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
LOMBERK_CONFIG Absolute path to the lomberk.yaml that `lomberk setup` wrote. The connection strings and keys are read from the .env beside it.Las descripciones siguen en el inglés original.
En la configuración de Lomberk, LOMBERK_AGENT_DSN, LOMBERK_ADMIN_DSN, LOMBERK_CONFIG está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Lomberk y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Lomberk o muestra una herramienta de Lomberk en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Lomberk (créala en el sitio del autor) · 1 ajuste(s) que rellenar (LOMBERK_CONFIG) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Lomberk para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "lomberk": { "type": "stdio", "command": "uvx", "args": [ "lomberk", "serve" ], "env": { "LOMBERK_CONFIG": "your-value", "LOMBERK_AGENT_DSN": "your-value", "LOMBERK_ADMIN_DSN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En LOMBERK_AGENT_DSN, LOMBERK_ADMIN_DSN, LOMBERK_CONFIG deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Lomberk aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
LOMBERK_CONFIG Absolute path to the lomberk.yaml that `lomberk setup` wrote. The connection strings and keys are read from the .env beside it.Las descripciones siguen en el inglés original.
En la configuración de Lomberk, LOMBERK_AGENT_DSN, LOMBERK_ADMIN_DSN, LOMBERK_CONFIG está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Lomberk y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Lomberk o muestra una herramienta de Lomberk en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user lomberk --env LOMBERK_CONFIG=your-value --env LOMBERK_AGENT_DSN=your-value --env LOMBERK_ADMIN_DSN=your-value -- uvx lomberk serveClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"lomberk": {
"command": "uvx",
"args": [
"lomberk",
"serve"
],
"env": {
"LOMBERK_CONFIG": "your-value",
"LOMBERK_AGENT_DSN": "your-value",
"LOMBERK_ADMIN_DSN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"lomberk": {
"command": "uvx",
"args": [
"lomberk",
"serve"
],
"env": {
"LOMBERK_CONFIG": "your-value",
"LOMBERK_AGENT_DSN": "your-value",
"LOMBERK_ADMIN_DSN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"lomberk": {
"type": "stdio",
"command": "uvx",
"args": [
"lomberk",
"serve"
],
"env": {
"LOMBERK_CONFIG": "your-value",
"LOMBERK_AGENT_DSN": "your-value",
"LOMBERK_ADMIN_DSN": "your-value"
}
}
}
}LOMBERK_CONFIG obligatorio envLOMBERK_AGENT_DSN secreto obligatorio envLOMBERK_ADMIN_DSN secreto obligatorio envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
pypi: lomberkSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub ege-usta, dueña del repo
Último cambio de código: hace 5 días
Usa Apache-2.0
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para lomberk@0.2.1
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/ege-usta-lomberk)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: LOMBERK_AGENT_DSN, LOMBERK_ADMIN_DSN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 5 días, y la última versión (0.2.1) llegó al registro hace 5 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: QueryWeaver, Supabase, Neon, DBCode, Keboola MCP
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
An MCP server for Text2SQL: transforms natural language into SQL using graph schema understanding.
MCP server for interacting with the Supabase platform
Official Neon MCP server for managing Neon projects and Lakebase Postgres databases.
Query and explore 100+ databases through your DBCode connections.
Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...
| Este Lomberk | QueryWeaver | Supabase | Neon | DBCode | Keboola MCP | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Se instala en tu equipo | En la nube o instalado en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | En la nube o instalado en tu equipo |
| Necesita clave | Sí | No | Sí | No | No | No |
| Se añade con + en Claude | No | No | Sí | Sí | No | No |
| Revisiones básicas | 3/3 | 3/3 | 5/5 | 5/5 | 2/3 | 5/5 |
| Licencia | Apache-2.0 | AGPL-3.0 | Apache-2.0 | MIT | NOASSERTION | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Every agent write, reversible. Lomberk is an MCP gateway for PostgreSQL. AI agents send SQL through it instead of holding database credentials. It blocks destructive commands, holds large or sensitive writes for a human, records every changed row, and can undo any applied write, including foreign-key cascades.
Just want a seatbelt for Claude Code? Lomberk Seatbelt is a free plugin that makes your agent ask before DROP, TRUNCATE, DELETE without WHERE, prisma migrate reset, dropdb and friends. Install it in two commands.
You need uv and the owner's connection string of a PostgreSQL 14+ database (a role that can create roles: postgres on Supabase, Neon and RDS).
uvx lomberk setup # asks for the owner connection string; what you type stays out of your shell history
In a script, set LOMBERK_INSTALL_DSN instead and add --yes. Setup creates two least-privilege roles with generated passwords, installs Lomberk, lists your tables and makes the ones you pick undoable, then writes lomberk.yaml and a private .env (mode 600) and runs lomberk doctor on them. It never changes a role or file that already exists. The owner connection string is used once and never saved. At the end it prints the line for your MCP client, for example:
claude mcp add lomberk -e LOMBERK_CONFIG=/path/to/lomberk.yaml -- uvx lomberk serve
Cursor, Claude Desktop, VS Code and Codex get their config snippet too. Then ask your agent to change something:
lomberk log # what your agents changed, newest first
lomberk undo cp_… # put it back, cascades included lomberk approve cp_… # let a held write run (or: lomberk reject cp_…) lomberk doctor # check the setup any time
Supabase, Neon, RDS, Railway: [docs/hosted-postgres.md](https://github.com/ege-usta/lomberk/blob/main/docs/hosted-postgres.md). On Supabase, use the **session pooler** connection string (IPv4); setup derives the `lomberk_agent.<project-ref>` login names from it.
| Tool | |
|---|---|
execute_sql | One statement through the hard gate, the policy and capture. Replies with a checkpoint (cp_…), APPROVAL REQUIRED, or why it was denied |
describe_tables | The tables it can use, their columns (secret ones hidden) and which writes wait for a human |
wait_for_approval | Waits for a person to approve or reject a held write, reporting progress, then says whether it ran |
checkpoint_status | What happened to one of its writes: waiting, applied, rejected or undone |
list_my_changes | Its own recent writes with their tokens, so it can tell you what to undo |
The agent can't approve or undo anything. That takes the admin key, the CLI or (Pro) Slack, SSO or the panel.
In April 2026 an autonomous coding agent deleted a production database in 9 seconds (through an over-privileged infrastructure token). Lomberk closes the other door: an agent's own database access. Here is what a rogue agent can and can't do when its SQL goes through Lomberk.
git clone https://github.com/ege-usta/lomberk && cd lomberk
docker compose up -d --build curl localhost:8000/readyz # {"status":"ready"}
This starts a demo `pocketos` database (`users` ← `payments` with `ON DELETE CASCADE`), installs Lomberk with two least-privilege roles, registers both tables, and starts the gateway.
claude mcp add --transport http lomberk http://localhost:8000/mcp \
--header "Authorization: Bearer demo-agent-key"
Any MCP client that speaks Streamable HTTP works the same way.
| Agent sends | Lomberk |
|---|---|
DROP TABLE public.users | Denied: DDL is structurally banned |
DELETE FROM public.users | Denied: write without WHERE |
DELETE FROM public.users WHERE id > 0 | Held: public.users is protected → APPROVAL REQUIRED. Token: cp_… |
UPDATE public.payments SET amount = 0 WHERE id > 0 | Applied, with a checkpoint: 2 rows on an unprotected table. One undo call puts the old amounts back |
The same write on more rows than max_rows_without_approval (10 in the demo) | Held: it ran, was counted and rolled back, and now waits for a person |
H="X-API-Key: demo-admin-key"
curl -H "$H" localhost:8000/v1/checkpoints/pending curl -H "$H" "localhost:8000/v1/checkpoints?status=applied" # recent writes, to find the cp_ to undo curl -H "$H" -X POST localhost:8000/v1/checkpoints/cp_…/approve # or /reject curl -H "$H" -X POST localhost:8000/v1/checkpoints/cp_…/undo # users AND cascaded payments come back
Pending requests expire after `agent.approval_timeout_minutes`. Review the exact SQL first with `GET /v1/checkpoints/cp_…` or `lomberk show cp_…`.
See the rows, not just the SQL. When a write is held, Lomberk runs it once, records what it changed and rolls it back, so the approver sees the effect before deciding, cascades included:
$ lomberk show cp_… # the agent sent: DELETE FROM public.users WHERE id = 1
would change: 2 row(s) in public.users (1), public.payments (1) (dry run when held) delete public.users {"id": "1"}: {"id": 1, "name": "Alice CEO", "plan": "enterprise", "email": "alice@pocketos.com", …} delete public.payments {"id": "1"}: {"id": 1, "amount": 1000.0, "status": "success", "user_id": 1}
The same preview is in the web panel and the API; Slack gets the counts only. Secret columns are masked, and columns hidden from the agent role never appear. A held write that would fail (a duplicate key, a missing parent) is refused at once instead of waiting for a person. The preview is a snapshot of the moment it was held. If a table's own triggers do something a rollback can't take back, set `approvals.preview: false`.
lomberk.yaml)limits:
max_rows_without_approval: 10 # larger writes are rolled back and held statement_timeout_ms: 15000 protected_tables: # any write, or FK cascade, reaching these is held
sensitive_columns: # like password: never shown to the agent, hidden by the DB on register
agent: approval_timeout_minutes: 30
Unknown keys fail startup, so a typo can never silently turn protection off. The gateway reads `./lomberk.yaml`; when it starts somewhere else (MCP clients usually launch `lomberk serve` from another directory), set `LOMBERK_CONFIG` to the file's absolute path. If that file is missing, startup is refused; a missing `./lomberk.yaml` only prints a warning and runs with defaults (no protected tables).
Environment: LOMBERK_CONFIG (path to lomberk.yaml), LOMBERK_ADMIN_DSN (control role), LOMBERK_AGENT_DSN (agent role), LOMBERK_API_KEY (agent), LOMBERK_ADMIN_KEY (approvers), LOMBERK_AUDIT_LOG (JSONL path), LOMBERK_LICENSE_KEY (Pro), LOMBERK_METRICS_KEY (turns on /metrics). Keys must be 32+ random characters (openssl rand -hex 32); the gateway refuses weak or demo keys unless LOMBERK_ALLOW_WEAK_KEYS=true (laptop demos only).
pip install lomberk # Slack and SSO: pip install "lomberk[pro]"; or: docker build -t lomberk .
export LOMBERK_INSTALL_DSN=postgresql://owner@db/app # used only for install
lomberk init --control-role lomberk_control --agent-role lomberk_agent lomberk register public.orders --agent-role lomberk_agent # repeat per table (and FK children) lomberk verify-ledger # tamper-evidence check
What an agent can't do, with the exact refusal for 20 real attacks: [docs/attack-gallery.md](https://github.com/ege-usta/lomberk/blob/main/docs/attack-gallery.md).
Step-by-step for Supabase, Neon, Amazon RDS and Railway (roles, connection strings, RLS, updated_at triggers): docs/hosted-postgres.md.
Common questions before adopting Lomberk: docs/faq.md.
Local, single-user development without the service: lomberk serve (stdio MCP). Do not use this mode with agents that have shell access. See SECURITY.md.
The web panel and audit export come with Solo and Pro; Slack approvals, approver SSO and the two-person rule are Pro.
Slack approvals and approver SSO need extra libraries: pip install "lomberk[pro]", or uvx --from "lomberk[pro]" lomberk serve. The Docker image has them. Without them the gateway refuses to start and says what to install.
Create the app from slack/app-manifest.json (bot scope chat:write only, Socket Mode, so no public URL is needed), invite the bot to your approvals channel, then:
slack:
channel_id: C0123APPROVALS team_allowlist: [T0123] admin_allowlist: [U0ALICE, U0BOB] # only these users' clicks count include_sql: false # default: SQL never leaves for Slack
```bash
LOMBERK_SLACK_ENABLED=true LOMBERK_SLACK_APP_TOKEN=xapp-… LOMBERK_SLACK_BOT_TOKEN=xoxb-…
Every held request is posted with Approve/Reject buttons, and the message updates to the final state. The approver's Slack ID is written to the audit log.
Approvers sign in with the company identity provider (Okta, Microsoft Entra ID, Google, Keycloak, any OIDC issuer) and send their ID token. The audit log then records the person (oidc:alice@corp.com), not a shared key.
sso:
issuer: https://corp.okta.com # keys are discovered from the issuer audience: lomberk-approvals # the client ID registered for Lomberk allowed_groups: [db-approvers] # and/or allowed_identities: [alice@corp.com]
```bash
curl -H "Authorization: Bearer $ID_TOKEN" -X POST localhost:8000/v1/checkpoints/cp_…/approve
Only asymmetrically signed tokens (RS/PS/ES) for this issuer and audience are accepted, and they must be unexpired. With the default `identity_claim: email`, the token must mark the email as verified. Entra ID does not send that flag, so set `identity_claim` to `upn` or `oid` there.
Open https:// /panel/ for writes waiting for approval, the history with who approved each one, one-click undo, and exports. Approvers sign in with SSO or the admin key. To offer "Sign in with SSO", register /panel/sso/callback as a redirect URI at your IdP:
sso:
pa