[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_120":121},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":-5,"_81":-5,"_82":-5,"_83":49,"_84":-5,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96},"apiUrl","https://odel.app/api","creator","keboola","moduleId","mcp-server","@keboola/mcp-server","displayName","mcp server","tagline","Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...","iconKey","https://avatars.githubusercontent.com/u/1424387?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.us-east4.gcp.keboola.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363271000,"updatedAt",1788409505000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=com.keboola%2Fmcp","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",86,"upstreamUpdatedAt",1788363759000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt",1787286383000,"githubRepoUrl","https://github.com/keboola/mcp-server","githubRepoFullName","keboola/mcp-server","releaseId","ext-keboola-mcp-server","version","1.80.1","descriptionMarkdown","[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/keboola/mcp-server)\n\n# Keboola MCP Server\n\n> Connect your AI agents, MCP clients (**Cursor**, **Claude**, **Windsurf**, **VS Code** ...) and other AI assistants to Keboola. Expose data, transformations, SQL queries, and job triggers—no glue code required. Deliver the right data to agents when and where they need it.\n\n## Overview\n\nKeboola MCP Server is an open-source bridge between your Keboola project and modern AI tools. It turns Keboola features—like storage access, SQL transformations, and job triggers—into callable tools for Claude, Cursor, CrewAI, LangChain, Amazon Q, and more.\n\n- [Quick Start](#-quick-start-remote-mcp-server-easiest-way)\n- [Local Setup](#local-mcp-server-setup-custom-or-dev-way)\n\n## Features\n\nWith the AI Agent and MCP Server, you can:\n\n- **Storage**: Query tables directly and manage table or bucket descriptions\n- **Components**: Create, List and inspect extractors, writers, data apps, and transformation configurations\n- **SQL**: Create SQL transformations with natural language\n- **Jobs**: Run components and transformations, and retrieve job execution details\n- **Flows**: Build and manage workflow pipelines using Conditional Flows and Orchestrator Flows.\n- **Data Apps**: Create, deploy and manage Keboola Streamlit Data Apps displaying your queries over storage data.\n- **Metadata**: Search, read, and update project documentation and object metadata using natural language\n- **Dev Branches**: Work safely in development branches outside of production, where all operations are scoped to the selected branch.\n\n---\n\n## 🚀 Quick Start: Remote MCP Server (Easiest Way)\n\nThe easiest way to use Keboola MCP Server is through our **Remote MCP Server**. This hosted solution eliminates the need for local setup, configuration, or installation.\n\n### What is the Remote MCP Server?\n\nOur remote server is hosted on every multi-tenant Keboola stack and supports OAuth authentication. You can connect to it from any AI assistant that supports remote Streamable HTTP connection and OAuth authentication.\n\n### How to Connect\n\n1. **Get your remote server URL**: Navigate to your Keboola Project Settings → `MCP Server` tab\n2. **Copy the server URL**: It will look like `https://mcp..keboola.com/mcp`\n3. **Configure your AI assistant**: Paste the URL into your AI assistant's MCP settings\n4. **Authenticate**: You'll be prompted to log in with your Keboola account. Which project(s) to work on is chosen afterwards, in the conversation (e.g. \"list my Keboola projects\" / \"use project X\")\n\n### Supported Clients\n\n- **[Cursor](https://cursor.com)**: Use the \"Install In Cursor\" button in your project's MCP Server settings or click\n this button\n [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=keboola&config=eyJ1cmwiOiJodHRwczovL21jcC51cy1lYXN0NC5nY3Aua2Vib29sYS5jb20vbWNwIn0%3D)\n- **[Claude Desktop](https://claude.ai)**: Add the integration via Settings → Integrations\n- **[Claude Code](https://www.anthropic.com/)**: Install using `claude mcp add --transport http keboola ` (see below for details)\n- **[Windsurf](https://windsurf.ai)**: Configure with the remote server URL\n- **[Make](https://make.com)**: Configure with the remote server URL\n- **Other MCP clients**: Configure with the remote server URL\n\n#### Claude Code Setup\n\nClaude Code is a command-line interface tool that allows you to interact with Claude using your terminal. You can install the Keboola MCP Server integration using a simple command.\n\n**Installation:**\n\nRun the following command in your terminal, replacing `` with your Keboola region:\n\n```bash\nclaude mcp add --transport http keboola https://mcp..keboola.com/mcp\n```\n\n**Region-specific commands:**\n\n| Region | Installation Command |\n|--------|----------------------|\n| US Virginia AWS | `claude mcp add --transport http keboola https://mcp.keboola.com/mcp` |\n| US Virginia GCP | `claude mcp add --transport http keboola https://mcp.us-east4.gcp.keboola.com/mcp` |\n| EU Frankfurt AWS | `claude mcp add --transport http keboola https://mcp.eu-central-1.keboola.com/mcp` |\n| EU Ireland Azure | `claude mcp add --transport http keboola https://mcp.north-europe.azure.keboola.com/mcp` |\n| EU Frankfurt GCP | `claude mcp add --transport http keboola https://mcp.europe-west3.gcp.keboola.com/mcp` |\n\n**Usage:**\n\nOnce installed, you can use the Keboola MCP Server in Claude Code by typing `/mcp` in your conversation and selecting the Keboola tools you want to use.\n\n**Authentication:**\n\nWhen you first use the Keboola MCP Server in Claude Code, a browser window will open prompting you to:\n1. Log in with your Keboola account\n2. Authorize the connection\n\nAfter authentication, you can start using Keboola tools directly from Claude Code. Project selection happens afterward, in the conversation — just ask Claude which Keboola project(s) to use.\n\nFor detailed setup instructions and region-specific URLs, see our [Remote Server Setup documentation](https://help.keboola.com/ai/mcp-server/#remote-server-setup).\n\n### Using Development Branches\nYou can work safely in [Keboola development branches](https://help.keboola.com/components/branches/) without affecting your production data. The remotely hosted MCP Servers respect the `KBC_BRANCH_ID` parameter and will scope all operations to the specified branch. You can find the development branch ID in the URL when navigating to the development branch in the UI, for example: `https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard`. The branch ID must be included in each request using the header `X-Branch-Id: `, otherwise the MCP Server uses production branch as default. This should be managed by the AI client or the environment handling the server connection.\n\n### Tool Authorization and Access Control\n\nWhen using HTTP-based transports (Streamable HTTP), you can control which tools are available to clients using HTTP headers. This is useful for restricting AI agent capabilities or enforcing compliance policies.\n\n#### Authorization Headers\n\n| Header | Description | Example |\n|--------|-------------|---------|\n| `X-Allowed-Tools` | Comma-separated list of allowed tools | `get_configs,get_buckets,query_data` |\n| `X-Disallowed-Tools` | Comma-separated list of tools to exclude | `create_config,run_job` |\n| `X-Read-Only-Mode` | Restrict to read-only tools only | `true`, `1`, or `yes` |\n\n#### Filter Behavior\n\nFilters apply in order: allowed → read-only intersection → disallowed exclusion. Empty headers = no restriction.\n\n#### Read-Only Tools\n\nRead-only tools are those annotated with `readOnlyHint=True`. These tools only retrieve information without making any changes to your Keboola project. For the current list of read-only tools, see the [TOOLS.md](https://github.com/keboola/mcp-server/blob/main/TOOLS.md) file which is an auto-generated snapshot of the actual tool set.\n\n#### Example: Read-Only Access\n\n```\nX-Read-Only-Mode: true\n```\n\nFor detailed documentation, see [developers.keboola.com/integrate/mcp/#tool-authorization-and-access-control](https://developers.keboola.com/integrate/mcp/#tool-authorization-and-access-control).\n\n---\n\n## Local MCP Server Setup (Custom or Dev Way)\n\nRun the MCP server on your own machine for full control and easy development. Choose this when you want to customize tools, debug locally, or iterate quickly. You’ll install the server, authenticate (a one-time browser login — no token to paste), and start it. This approach offers maximum flexibility (custom tools, local logging, offline iteration) but requires manual setup and you manage updates and secrets yourself.\n\nThe server supports multiple **transport** options, which can be selected by providing the `--transport ` argument when starting the server:\n- `stdio` - Default when `--transport` is not specified. Standard input/output, typically used for local deployment with a single client.\n- `streamable-http` - Runs the server remotely over HTTP with a bidirectional streaming channel, allowing the client and server to continuously exchange messages. Connect via /mcp (e.g., http://localhost:8000/mcp).\n- `http-compat` - An alias for `streamable-http`, kept for backwards compatibility.\n\nTo work with your Keboola project the server needs two things: your **Keboola Region** (`KBC_STORAGE_API_URL`) and a way to **authenticate**. The recommended way is a one-time browser **login** — you never create, copy, or paste a token. Optionally set `KBC_BRANCH_ID` to work inside a development branch.\n\nSome of the variables are not taken from the request headers:\n- `KBC_STORAGE_API_URL`: a server that was started with its own Storage API URL (the `--api-url` parameter or the `KBC_STORAGE_API_URL` environment variable) only serves that one Keboola stack. An `X-Storage-Api-Url` header asking for a different host is ignored (a warning is logged) — the server keeps its own URL for the request. Start the server without a Storage API URL of its own if you want each request to choose its stack.\n- `KBC_KUBERNETES_TOKEN_PATH` (deployed servers only, see [docs/kubernetes-sa-auth.md](https://github.com/keboola/mcp-server/blob/main/docs/kubernetes-sa-auth.md)): read from the environment only, never from a header.\n- `KBC_WORKSPACE_ID` / `KBC_WORKSPACE_SCHEMA`: same idea as the Storage API URL above — a server started with its own workspace pin (via either variable, or `--workspace-id`) keeps that pin for every request; an `X-Workspace-Id` or `X-Workspace-Schema` header asking for a different workspace is ignored (a warning is logged). A server with no pin of its own (the shared multi-user case) keeps taking the pin from the request, per-request, as described below.\n\n### Logging in\n\nSign in once with your browser; the server stores the session and refreshes it automatically, so there are no tokens to manage:\n\n```bash\nuvx keboola_mcp_server login --api-url https://connection.YOUR_REGION.keboola.com\n```\n\nThis opens your browser to sign in to Keboola, then saves the stack-wide session to `~/.keboola/mcp/credentials.json` (readable only by you, one entry per stack). Afterwards, start the server with only `KBC_STORAGE_API_URL` set — no token required. Which project(s) to work on is chosen afterwards, in the conversation (`get_accessible_projects` / `set_project_scope`), not during login.\n\n| Command | What it does |\n|---------|--------------|\n| `login --api-url ` | Sign in to a stack |\n| `login --force` | Sign in again / switch account |\n| `login --show-token` | Print the current session token (debugging) |\n| `logout [--api-url ] [--all]` | Remove the stored session for a stack (or all stacks) |\n\nWhen you start the server over **stdio in an interactive terminal** with no stored session, it runs this browser login automatically on first start. MCP clients (Claude, Cursor, …) launch the server in the background where a browser can't open, so run `login` once yourself first.\n\n#### Authenticating without a browser\n\nFor containers or CI where a browser login isn't possible, provide a Keboola [access or personal access token](https://help.keboola.com/management/project/tokens/) directly — set `KBC_STORAGE_TOKEN` (env var) or send the `X-StorageAPI-Token` header — together with `KBC_PROJECT_ID` (or the `X-KBC-ProjectId` header) to select the project. On HTTP transports these can be supplied per request as headers, so each request carries its own credentials.\n\n### KBC_WORKSPACE_ID\n\nPins queries to one specific, already-existing workspace by its ID instead of the schema-based lookup above, and takes precedence over `KBC_WORKSPACE_SCHEMA` when both are set. This is the option a Data App / kai-agent caller supplies, as the `X-Workspace-Id` header, so that Kai embedded in that app queries only through its own workspace.\n\nSet via the `KBC_WORKSPACE_ID` environment variable, the `--workspace-id` CLI flag, or (per-request, for multi-user deployments) the `X-Workspace-Id` header.\n\n### KBC_STORAGE_API_URL (Keboola Region)\n\nYour Keboola Region API URL depends on your deployment region. You can determine your region by looking at the URL in your browser when logged into your Keboola project:\n\n| Region | API URL |\n|--------|---------|\n| AWS North America | `https://connection.keboola.com` |\n| AWS Europe | `https://connection.eu-central-1.keboola.com` |\n| Google Cloud EU | `https://connection.europe-west3.gcp.keboola.com` |\n| Google Cloud US | `https://connection.us-east4.gcp.keboola.com` |\n| Azure EU | `https://connection.north-europe.azure.keboola.com` |\n\n### KBC_BRANCH_ID (Optional)\n\nTo operate on a specific [Keboola development branch](https://help.keboola.com/components/branches/), set the branch ID using the `KBC_BRANCH_ID` parameter. The MCP server scopes its functionality to the specified branch, ensuring all changes remain isolated and do not impact the production branch.\n\n- If not provided, the server uses the production branch by default.\n- For development work, set `KBC_BRANCH_ID` to the numeric ID of your branch (e.g., `123456`). You can find the development branch ID in the URL when navigating to the development branch in the UI, for example: `https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard`.\n- On remote transports, you can override per-request with the HTTP header `X-Branch-Id: ` or `KBC_BRANCH_ID: `.\n\n\n### Installation\n\nMake sure you have:\n\n- [ ] Python 3.10+ installed\n- [ ] Access to a Keboola project with admin rights\n- [ ] Your preferred MCP client (Claude, Cursor, etc.)\n\n**Note**: Make sure you have `uv` installed. The MCP client will use it to automatically download and run the Keboola MCP Server.\n**Installing uv**:\n\n*macOS/Linux*:\n\n```bash\n#if homebrew is not installed on your machine use:\n# /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n\n# Install using Homebrew\nbrew install uv\n```\n\n*Windows*:\n\n```powershell\n# Using the installer script\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n\n# Or using pip\npip install uv\n\n# Or using winget\nwinget install --id=astral-sh.uv -e\n```\n\nFor more installation options, see the [official uv documentation](https://docs.astral.sh/uv/getting-started/installation/).\n\n\n### Running Keboola MCP Server\n\nThere are four ways to use the Keboola MCP Server, depending on your needs:\n\n### Option A: Integrated Mode (Recommended)\n\nIn this mode, Claude or Cursor automatically starts the MCP server for you.\n\n1. **Log in once** in a terminal so a session is stored (the client launches the server in the background, where a browser can't open):\n ```bash\n uvx keboola_mcp_server login --api-url https://connection.YOUR_REGION.keboola.com\n ```\n2. Configure your MCP client (Claude/Cursor) with the settings below — only `KBC_STORAGE_API_URL` is needed.\n3. The client will automatically launch the MCP server when needed.\n\n#### Claude Desktop Configuration\n\n1. Go to Claude (top left corner of your screen) -> Settings → Developer → Edit Config (if you don't see the claude_desktop_config.json, create it)\n2. Add the following configuration:\n3. Restart Claude desktop for changes to take effect\n\n```json\n{\n \"mcpServers\": {\n \"keboola\": {\n \"command\": \"uvx\",\n \"args\": [\"keboola_mcp_server --transport \"],\n \"env\": {\n \"KBC_STORAGE_API_URL\": \"https://connection.YOUR_REGION.keboola.com\",\n \"KBC_BRANCH_ID\": \"your_branch_id_optional\"\n }\n }\n }\n}\n```\n\nConfig file locations:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n#### Cursor Configuration\n\n1. Go to Settings → MCP\n2. Click \"+ Add new global MCP Server\"\n3. Configure with these settings:\n\n```json\n{\n \"mcpServers\": {\n \"keboola\": {\n \"command\": \"uvx\",\n \"args\": [\"keboola_mcp_server --transport \"],\n \"env\": {\n \"KBC_STORAGE_API_URL\": \"https://connection.YOUR_REGION.keboola.com\",\n \"KBC_BRANCH_ID\": \"your_branch_id_optional\"\n }\n }\n }\n}\n```\n\n**Note**: Use short, descriptive names for MCP servers. Since the full tool name includes the server name and must stay under ~60 characters, longer names may be filtered out in Cursor and will not be displayed to the Agent.\n\n\n#### Cursor Configuration for Windows WSL\n\nWhen running the MCP server from Windows Subsystem for Linux with Cursor AI, use this configuration:\n\n```json\n{\n \"mcpServers\": {\n \"keboola\":{\n \"command\": \"wsl.exe\",\n \"args\": [\n \"bash\",\n \"-c '\",\n \"export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com &&\",\n \"export KBC_BRANCH_ID=your_branch_id_optional &&\",\n \"/snap/bin/uvx keboola_mcp_server --transport \",\n \"'\"\n ]\n }\n }\n}\n```\n\n### Option B: Local Development Mode\n\nFor developers working on the MCP server code itself:\n\n1. Clone the repository and set up a local environment\n2. Configure Claude/Cursor to use your local Python path:\n\n```json\n{\n \"mcpServers\": {\n \"keboola\": {\n \"command\": \"/absolute/path/to/.venv/bin/python\",\n \"args\": [\n \"-m\",\n \"keboola_mcp_server --transport \"\n ],\n \"env\": {\n \"KBC_STORAGE_API_URL\": \"https://connection.YOUR_REGION.keboola.com\",\n \"KBC_BRANCH_ID\": \"your_branch_id_optional\"\n }\n }\n }\n}\n```\n\n### Option C: Manual CLI Mode (For Testing Only)\n\nYou can run the server manually in a terminal for testing or debugging:\n\n```bash\n# Sign in once (stores a session under ~/.keboola/mcp), then start the server.\nexport KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com\nuvx keboola_mcp_server login --api-url \"$KBC_STORAGE_API_URL\"\n\nuvx keboola_mcp_server --transport streamable-http\n```\n\n> **Note**: This mode is primarily for debugging or testing. For normal use with Claude or Cursor,\n> you do not need to manually run the server.\n\n> **Note**: The server will use the Streamable HTTP transport and listen on `localhost:8000` for incoming connections at `/mcp`.\n> You can use `--port` and `--host` parameters to make it listen elsewhere.\n\n### Option D: Using Docker\n\nA container can't open a browser, so authenticate with a token (see [Authenticating without a browser](#authenticating-without-a-browser)): set `KBC_STORAGE_TOKEN` to a Keboola access/personal access token and `KBC_PROJECT_ID` to the target project. (Over HTTP you can instead pass `X-StorageAPI-Token` / `X-KBC-ProjectId` headers per request and omit these.)\n\n```shell\ndocker pull keboola/mcp-server:latest\n\ndocker run \\\n --name keboola_mcp_server \\\n --rm \\\n -it \\\n -p 127.0.0.1:8000:8000 \\\n -e KBC_STORAGE_API_URL=\"https://connection.YOUR_REGION.keboola.com\" \\\n -e KBC_STORAGE_TOKEN=\"YOUR_KEBOOLA_TOKEN\" \\\n -e KBC_PROJECT_ID=\"YOUR_PROJECT_ID\" \\\n -e KBC_BRANCH_ID=\"YOUR_BRANCH_ID_OPTIONAL\" \\\n keboola/mcp-server:latest \\\n --transport streamable-http \\\n --host 0.0.0.0\n```\n\n> **Note**: The server will use the Streamable HTTP transport and listen on `localhost:8000` for incoming connections at `/mcp`.\n> You can change `-p` to map the container's port somewhere else.\n\n### Do I Need to Start the Server Myself?\n\n| Scenario | Need to Run Manually? | Use This Setup |\n|----------|----------------------|----------------|\n| Using Claude/Cursor | No | Configure MCP in app settings |\n| Developing MCP locally | No (Claude starts it) | Point config to python path |\n| Testing CLI manually | Yes | Use terminal to run |\n| Using Docker | Yes | Run docker container |\n\n## Using MCP Server\n\nOnce your MCP client (Claude/Cursor) is configured and running, you can start querying your Keboola data:\n\n### Verify Your Setup\n\nYou can start with a simple query to confirm everything is working:\n\n```text\nWhat buckets and tables are in my Keboola project?\n```\n\n### Examples of What You Can Do\n\n**Data Exploration:**\n\n- \"What tables contain customer information?\"\n- \"Run a query to find the top 10 customers by revenue\"\n\n**Data Analysis:**\n\n- \"Analyze my sales data by region for the last quarter\"\n- \"Find correlations between customer age and purchase frequency\"\n\n**Data Pipelines:**\n\n- \"Create a SQL transformation that joins customer and order tables\"\n- \"Start the data extraction job for my Salesforce component\"\n\n## Compatibility\n\n### MCP Client Support\n\n| **MCP Client** | **Support Status** | **Connection Method** |\n|----------------|-------------------|----------------------|\n| Claude (Desktop & Web) | ✅ supported | stdio |\n| Cursor | ✅ supported | stdio |\n| Windsurf, Zed, Replit | ✅ Supported | stdio |\n| Codeium, Sourcegraph | ✅ Supported | Streamable HTTP |\n| Custom MCP Clients | ✅ Supported | Streamable HTTP or stdio |\n\n## Supported Tools\n\n**Note:** Your AI agents will automatically adjust to new tools.\n\nFor a complete list of available tools with detailed descriptions, parameters, and usage examples, see [TOOLS.md](https://github.com/keboola/mcp-server/blob/main/TOOLS.md).\n\n## Troubleshooting\n\n### Common Issues\n\n| Issue | Solution |\n|-------|----------|\n| **Authentication Errors** | Re-run `keboola_mcp_server login` (or, if authenticating with a token, verify the token and `KBC_PROJECT_ID`) |\n| **Connection Timeout** | Check network connectivity |\n\n## Development\n\n### Installation\n\nBasic setup:\n\n```bash\nuv sync --extra dev\n```\n\nWith the basic setup, you can use `uv run tox` to run tests and check code style.\n\nRecommended setup:\n\n```bash\nuv sync --extra dev --extra tests --extra integtests --extra codestyle\n```\n\nWith the recommended setup, packages for testing and code style checking will be installed which allows IDEs like\nVsCode or Cursor to check the code or run tests during development.\n\n### Integration tests\n\nTo run integration tests locally, use `uv run tox -e integtests`.\nNOTE: You will need to set the following environment variables:\n\n- `INTEGTEST_POOL_STORAGE_API_URL`\n- `INTEGTEST_STORAGE_TOKENS`\n- `INTEGTEST_STORAGE_TOKEN_STORAGE_BRANCHES`\n\nIn order to get these values, you need dedicated Keboola projects for integration tests.\nEach test session creates its own read-only workspace, so no workspace schema needs to be\nconfigured. See `integtests/README.md` for detailed setup instructions and design documentation.\n\n### Updating `uv.lock`\n\nUpdate the `uv.lock` file if you have added or removed dependencies. Also consider updating the lock with newer dependency\nversions when creating a release (`uv lock --upgrade`).\n\n### Updating Tool Documentation\n\nWhen you make changes to any tool descriptions (docstrings in tool functions), you must regenerate the `TOOLS.md` documentation file to reflect these changes:\n\n```bash\nuv run python -m src.keboola_mcp_server.generate_tool_docs\n```\n\n### Releasing\n\nWe do **not** cut a release for every merged PR. Work lands on the trunk (`main`)\ncontinuously, and we release periodically once changes have been re-tested together —\nthis avoids breaking working setups for users.\n\nA release is made by pushing **one or two git tags**:\n\n- `vX.Y.Z` — the MCP server release (always)\n- `agent-vX.Y.Z` — the In Platform Agent release (only when the agent is being released too)\n\nEither tag triggers `release.yml` CI, which builds and publishes the Docker image. KaiBench\nruns only on production `vX.Y.Z` tags (not `agent-vX.Y.Z`, and not `-dev.` prereleases). Use\nthe `release-notes` skill — it prepares the release notes and draft PR and walks through\ntagging both `vX.Y.Z` and `agent-vX.Y.Z`.\n\n## Support and Feedback\n\n**⭐ The primary way to get help, report bugs, or request features is by [opening an issue on GitHub](https://github.com/keboola/mcp-server/issues/new). ⭐**\n\nThe development team actively monitors issues and will respond as quickly as possible. For general information about Keboola, please use the resources below.\n\n## Resources\n\n- [User Documentation](https://help.keboola.com/)\n- [Developer Documentation](https://developers.keboola.com/)\n- [Keboola Platform](https://www.keboola.com)\n- [Issue Tracker](https://github.com/keboola/mcp-server/issues/new) ← **Primary contact method for MCP Server**\n\n## Connect\n\n- [LinkedIn](https://www.linkedin.com/company/keboola)\n- [Twitter](https://x.com/keboola)\n- [Changelog](https://changelog.keboola.com/)\n\n\n[//]: # (mcp-name: com.keboola/mcp -- keep this line for registry.modelcontextprotocol.io)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_102":103,"_104":105,"_106":107,"_108":109,"_110":-5,"_111":112},"requiredSecrets",[],"tags",[99,100,101],"assets",[],"stats",{"_97":86,"_98":86},"ratingAvg","reviewCount","data-platform","etl-pipeline","keboola-platform","topics",[99,100,101,118,21,119],"license","MIT","language","Python","registryName","com.keboola/mcp","homepage","packages",[113],{"_114":115,"_116":117,"_76":77},"registryType","pypi","identifier","keboola-mcp-server","mcp","model-context-protocol","ENV",{"_122":123,"_124":125,"_126":127},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]