diff --git a/README.md b/README.md
index cba83f8..d1de0c2 100644
--- a/README.md
+++ b/README.md
@@ -100,6 +100,19 @@ Change you needed database and source to the `*.sql` dump.
 
 Dump must be extracted before source in mysql-cli
 
+### MariaDB MCP (Cursor IDE)
+
+Optional MCP server so Cursor can query the `db` container over the Docker network (SSE on localhost).
+
+1. Start your stack so the `db` service is running (`dc up -d` or your usual compose files).
+2. Find the Docker network name that `db` uses: `docker network ls` (often `<project-folder>_default`). Set `INTAI_DOCKER_NETWORK` in `.env` (see `.env.example`).
+3. Copy `.env.mcp-mariadb.example` to `.env.mcp-mariadb` and set `DB_PASSWORD` (and optional `DB_NAME`) to match `MYSQL_ROOT_PASSWORD` / your database.
+4. Build and start the MCP container: `docker compose -f docker-compose.mcp-mariadb.yml.example up -d --build`
+5. Ensure `.cursor/mcp.json` uses the same host port as `MCP_MARIADB_PORT` in `.env` (default `8765`, URL path `/sse`).
+6. Restart Cursor and enable the **intai-mariadb** MCP server in MCP settings.
+
+First image build can take a while (upstream MariaDB MCP dependencies).
+
 ### Workspace
 
 For execute composer update|install or nodejs operations, also yarn, npm and all node-builds.