Skip to main content
Glama
keboola

Keboola Explorer MCP Server

Keboola MCP Server

Verbinden Sie Ihre KI-Agenten, MCP-Clients ( Cursor , Claude , Windsurf , VS Code usw.) und andere KI-Assistenten mit Keboola. Stellen Sie Daten, Transformationen, SQL-Abfragen und Job-Trigger bereit – ganz ohne Glue-Code. Liefern Sie den Agenten die richtigen Daten, wann und wo sie diese benötigen.

Überblick

Der Keboola MCP Server ist eine Open-Source-Brücke zwischen Ihrem Keboola-Projekt und modernen KI-Tools. Er verwandelt Keboola-Funktionen – wie Speicherzugriff, SQL-Transformationen und Job-Trigger – in aufrufbare Tools für Claude, Cursor, CrewAI, LangChain, Amazon Q und mehr.

Related MCP server: Google BigQuery MCP Server by CData

Merkmale

  • Speicher : Tabellen direkt abfragen und Tabellen- oder Bucket-Beschreibungen verwalten

  • Komponenten : Erstellen, Auflisten und Überprüfen von Extraktoren, Writern, Daten-Apps und Transformationskonfigurationen

  • SQL : Erstellen Sie SQL-Transformationen mit natürlicher Sprache

  • Jobs : Führen Sie Komponenten und Transformationen aus und rufen Sie Details zur Jobausführung ab

  • Metadaten : Suchen, lesen und aktualisieren Sie Projektdokumentation und Objektmetadaten mithilfe natürlicher Sprache

Vorbereitungen

Stellen Sie sicher, dass Sie über Folgendes verfügen:

  • [ ] Python 3.10+ installiert

  • [ ] Zugriff auf ein Keboola-Projekt mit Administratorrechten

  • [ ] Ihr bevorzugter MCP-Client (Claude, Cursor usw.)

Hinweis : Stellen Sie sicher, dass Sie uv installiert haben. Der MCP-Client verwendet es, um den Keboola MCP-Server automatisch herunterzuladen und auszuführen. Installation von uv :

macOS/Linux :

#if homebrew is not installed on your machine use:
# /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install using Homebrew
brew install uv

Windows :

# Using the installer script
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or using pip
pip install uv

# Or using winget
winget install --id=astral-sh.uv -e

Weitere Installationsoptionen finden Sie in der offiziellen UV-Dokumentation .

Bevor Sie den MCP-Server einrichten, benötigen Sie drei wichtige Informationen:

KBC_STORAGE_TOKEN

Dies ist Ihr Authentifizierungstoken für Keboola:

Anweisungen zum Erstellen und Verwalten von Storage-API-Token finden Sie in der offiziellen Keboola-Dokumentation .

Hinweis : Wenn Sie dem MCP-Server nur eingeschränkten Zugriff gewähren möchten, verwenden Sie ein benutzerdefiniertes Speichertoken. Wenn Sie möchten, dass der MCP auf alles in Ihrem Projekt zugreift, verwenden Sie das Mastertoken.

KBC_WORKSPACE_SCHEMA

Dies identifiziert Ihren Arbeitsbereich in Keboola und wird für SQL-Abfragen benötigt:

Folgen Sie dieser Keboola-Anleitung, um Ihr KBC_WORKSPACE_SCHEMA zu erhalten.

Hinweis : Aktivieren Sie beim Erstellen des Arbeitsbereichs die Option „Nur Lesezugriff auf alle Projektdaten gewähren“

Keboola-Region

Ihre Keboola-API-URL hängt von Ihrer Bereitstellungsregion ab. Sie können Ihre Region ermitteln, indem Sie die URL in Ihrem Browser anzeigen, wenn Sie in Ihrem Keboola-Projekt angemeldet sind:

Region

API-URL

AWS Nordamerika

https://connection.keboola.com

AWS Europa

https://connection.eu-central-1.keboola.com

Google Cloud EU

https://connection.europe-west3.gcp.keboola.com

Google Cloud US

https://connection.us-east4.gcp.keboola.com

Azure EU

https://connection.north-europe.azure.keboola.com

BigQuery-spezifisches Setup

Wenn Ihr Keboola-Projekt das BigQuery-Backend verwendet, müssen Sie zusätzlich zu KBC_STORAGE_TOKEN und KBC_WORKSPACE_SCHEMA die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS festlegen:

  1. Gehen Sie zu Ihrem Keboola BigQuery-Arbeitsbereich und zeigen Sie dessen Anmeldeinformationen an (klicken Sie auf die Schaltfläche „Verbinden“).

  2. Laden Sie die Anmeldeinformationsdatei auf Ihre lokale Festplatte herunter. Es handelt sich um eine einfache JSON-Datei

  3. Legen Sie den vollständigen Pfad der heruntergeladenen JSON-Anmeldeinformationsdatei auf die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS fest.

  4. Dadurch erhält Ihre MCP-Serverinstanz die Berechtigung, auf Ihren BigQuery-Arbeitsbereich in Google Cloud zuzugreifen. Hinweis : KBC_WORKSPACE_SCHEMA wird im BigQuery-Arbeitsbereich als Dataset-Name bezeichnet. Klicken Sie einfach auf „Verbinden“ und kopieren Sie den Dataset-Namen.

Ausführen des Keboola MCP-Servers

Es gibt vier Möglichkeiten, den Keboola MCP-Server zu verwenden, je nach Ihren Anforderungen:

Option A: Integrierter Modus (empfohlen)

In diesem Modus startet Claude oder Cursor den MCP-Server automatisch für Sie. Sie müssen keine Befehle in Ihrem Terminal ausführen .

  1. Konfigurieren Sie Ihren MCP-Client (Claude/Cursor) mit den entsprechenden Einstellungen

  2. Der Client startet den MCP-Server bei Bedarf automatisch

Claude Desktop-Konfiguration

  1. Gehen Sie zu Claude (obere linke Ecke Ihres Bildschirms) -> Einstellungen → Entwickler → Konfiguration bearbeiten (wenn Sie die Datei claude_desktop_config.json nicht sehen, erstellen Sie sie).

  2. Fügen Sie die folgende Konfiguration hinzu:

  3. Starten Sie Claude Desktop neu, damit die Änderungen wirksam werden

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": [
        "keboola_mcp_server",
        "--api-url", "https://connection.YOUR_REGION.keboola.com"
      ],
      "env": {
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema"
      }
    }
  }
}

Hinweis : Für BigQuery-Benutzer fügen Sie die folgende Zeile in „env“ ein: {}: „GOOGLE_APPLICATION_CREDENTIALS“: „/full/path/to/credentials.json“

Speicherorte der Konfigurationsdateien:

  • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows : %APPDATA%\Claude\claude_desktop_config.json

Cursorkonfiguration

  1. Gehen Sie zu Einstellungen → MCP

  2. Klicken Sie auf „+ Neuen globalen MCP-Server hinzufügen“.

  3. Konfigurieren Sie mit diesen Einstellungen:

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": [
        "keboola_mcp_server",
        "--api-url", "https://connection.YOUR_REGION.keboola.com"
      ],
      "env": {
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema"
      }
    }
  }
}

Hinweis : Für BigQuery-Benutzer fügen Sie die folgende Zeile in „env“ ein: {}: „GOOGLE_APPLICATION_CREDENTIALS“: „/full/path/to/credentials.json“

Cursorkonfiguration für Windows WSL

Wenn Sie den MCP-Server vom Windows-Subsystem für Linux mit Cursor AI ausführen, verwenden Sie diese Konfiguration:

{
  "mcpServers": {
    "keboola": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "'source /wsl_path/to/keboola-mcp-server/.env",
        "&&",
        "/wsl_path/to/keboola-mcp-server/.venv/bin/python -m keboola_mcp_server.cli --transport stdio'"
      ]
    }
  }
}

Wobei die Datei /wsl_path/to/keboola-mcp-server/.env Umgebungsvariablen enthält:

export KBC_STORAGE_TOKEN="your_keboola_storage_token"
export KBC_WORKSPACE_SCHEMA="your_workspace_schema"

Option B: Lokaler Entwicklungsmodus

Für Entwickler, die am MCP-Servercode selbst arbeiten:

  1. Klonen Sie das Repository und richten Sie eine lokale Umgebung ein

  2. Konfigurieren Sie Claude/Cursor so, dass Ihr lokaler Python-Pfad verwendet wird:

{
  "mcpServers": {
    "keboola": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": [
        "-m", "keboola_mcp_server.cli",
        "--transport", "stdio",
        "--api-url", "https://connection.YOUR_REGION.keboola.com"
      ],
      "env": {
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema",

      }
    }
  }
}

Hinweis : Für BigQuery-Benutzer fügen Sie die folgende Zeile in „env“ ein: {}: „GOOGLE_APPLICATION_CREDENTIALS“: „/full/path/to/credentials.json“

Option C: Manueller CLI-Modus (nur zum Testen)

Sie können den Server zum Testen oder Debuggen manuell in einem Terminal ausführen:

# Set environment variables
export KBC_STORAGE_TOKEN=your_keboola_storage_token
export KBC_WORKSPACE_SCHEMA=your_workspace_schema
# For BigQuery users
# export GOOGLE_APPLICATION_CREDENTIALS=/full/path/to/credentials.json

# Run with uvx (no installation needed)
uvx keboola_mcp_server --api-url https://connection.YOUR_REGION.keboola.com

# OR, if developing locally
python -m keboola_mcp_server.cli --api-url https://connection.YOUR_REGION.keboola.com

Hinweis : Dieser Modus dient in erster Linie zum Debuggen oder Testen. Für die normale Verwendung mit Claude oder Cursor müssen Sie den Server nicht manuell starten.

Option D: Verwenden von Docker

docker pull keboola/mcp-server:latest

# For Snowflake users
docker run -it \
  -e KBC_STORAGE_TOKEN="YOUR_KEBOOLA_STORAGE_TOKEN" \
  -e KBC_WORKSPACE_SCHEMA="YOUR_WORKSPACE_SCHEMA" \
  keboola/mcp-server:latest \
  --api-url https://connection.YOUR_REGION.keboola.com

# For BigQuery users (add credentials volume mount)
# docker run -it \
#   -e KBC_STORAGE_TOKEN="YOUR_KEBOOLA_STORAGE_TOKEN" \
#   -e KBC_WORKSPACE_SCHEMA="YOUR_WORKSPACE_SCHEMA" \
#   -e GOOGLE_APPLICATION_CREDENTIALS="/creds/credentials.json" \
#   -v /local/path/to/credentials.json:/creds/credentials.json \
#   keboola/mcp-server:latest \
#   --api-url https://connection.YOUR_REGION.keboola.com

Muss ich den Server selbst starten?

Szenario

Müssen Sie es manuell ausführen?

Verwenden Sie dieses Setup

Verwenden von Claude/Cursor

NEIN

Konfigurieren Sie MCP in den App-Einstellungen

MCP lokal entwickeln

Nein (Claude fängt an)

Richten Sie die Konfiguration auf den Python-Pfad aus

Manuelles Testen der CLI

Ja

Verwenden Sie das Terminal zum Ausführen

Verwenden von Docker

Ja

Docker-Container ausführen

Verwenden des MCP-Servers

Sobald Ihr MCP-Client (Claude/Cursor) konfiguriert und ausgeführt wird, können Sie mit der Abfrage Ihrer Keboola-Daten beginnen:

Überprüfen Sie Ihr Setup

Sie können mit einer einfachen Abfrage beginnen, um zu bestätigen, dass alles funktioniert:

What buckets and tables are in my Keboola project?

Beispiele dafür, was Sie tun können

Datenexploration:

  • „Welche Tabellen enthalten Kundeninformationen?“

  • „Führen Sie eine Abfrage aus, um die 10 Kunden mit dem höchsten Umsatz zu finden.“

Datenanalyse:

  • „Analysieren Sie meine Verkaufsdaten nach Regionen für das letzte Quartal“

  • „Finden Sie Zusammenhänge zwischen Kundenalter und Kaufhäufigkeit“

Datenpipelines:

  • „Erstellen Sie eine SQL-Transformation, die Kunden- und Bestelltabellen verbindet.“

  • „Starten Sie den Datenextraktionsjob für meine Salesforce-Komponente.“

Kompatibilität

MCP-Client-Support

MCP-Client

Support-Status

Verbindungsmethode

Claude (Desktop & Web)

✅ unterstützt, getestet

stdio

Cursor

✅ unterstützt, getestet

stdio

Windsurfen, Zed, Replit

✅ Unterstützt

stdio

Codeium, Sourcegraph

✅ Unterstützt

HTTP+SSE

Benutzerdefinierte MCP-Clients

✅ Unterstützt

HTTP+SSE oder stdio

Unterstützte Tools

Hinweis: Keboola MCP ist älter als Version 1.0, daher können einige wichtige Änderungen auftreten. Ihre KI-Agenten passen sich automatisch an neue Tools an.

Kategorie

Werkzeug

Beschreibung

Lagerung

retrieve_buckets

Listet alle Speicherbereiche in Ihrem Keboola-Projekt auf

get_bucket_detail

Ruft detaillierte Informationen zu einem bestimmten Bucket ab

retrieve_bucket_tables

Gibt alle Tabellen innerhalb eines bestimmten Buckets zurück

get_table_detail

Bietet detaillierte Informationen zu einer bestimmten Tabelle

update_bucket_description

Aktualisiert die Beschreibung eines Buckets

update_column_description

Aktualisiert die Beschreibung für eine bestimmte Spalte in einer Tabelle.

update_table_description

Aktualisiert die Beschreibung einer Tabelle

SQL

query_table

Führt benutzerdefinierte SQL-Abfragen für Ihre Daten aus

get_sql_dialect

Gibt an, ob Ihr Arbeitsbereich den Snowflake- oder BigQuery-SQL-Dialekt verwendet.

Komponente

create_component_root_configuration

Erstellt eine Komponentenkonfiguration mit benutzerdefinierten Parametern

create_component_row_configuration

Erstellt eine Komponentenkonfigurationszeile mit benutzerdefinierten Parametern

create_sql_transformation

Erstellt eine SQL-Transformation mit benutzerdefinierten Abfragen

find_component_id

Gibt eine Liste der Komponenten-IDs zurück, die der angegebenen Abfrage entsprechen

get_component

Ruft Informationen zu einer bestimmten Komponente anhand ihrer ID ab.

get_component_configuration

Ruft Informationen zu einer bestimmten Komponenten-/Transformationskonfiguration ab

get_component_configuration_examples

Ruft Beispielkonfigurationen für eine bestimmte Komponente ab

retrieve_component_configurations

Ruft Konfigurationen der im Projekt vorhandenen Komponenten ab

retrieve_transformations

Ruft Transformationskonfigurationen im Projekt ab

update_component_root_configuration

Aktualisiert eine bestimmte Komponentenkonfiguration

update_component_row_configuration

Aktualisiert eine bestimmte Komponentenkonfigurationszeile

update_sql_transformation_configuration

Aktualisiert eine vorhandene SQL-Transformationskonfiguration

Arbeit

retrieve_jobs

Listet und filtert Jobs nach Status, Komponente oder Konfiguration

get_job_detail

Gibt umfassende Details zu einem bestimmten Job zurück

start_job

Löst die Ausführung eines Komponenten- oder Transformationsjobs aus

Dokumentation

docs_query

Durchsucht die Keboola-Dokumentation basierend auf Abfragen in natürlicher Sprache

Fehlerbehebung

Häufige Probleme

Ausgabe

Lösung

Authentifizierungsfehler

Überprüfen Sie, ob KBC_STORAGE_TOKEN gültig ist

Probleme mit dem Arbeitsbereich

Bestätigen Sie, KBC_WORKSPACE_SCHEMA korrekt ist

Verbindungstimeout

Überprüfen der Netzwerkkonnektivität

Entwicklung

Installation

Grundkonfiguration:

uv sync --extra dev

Mit der Grundkonfiguration können Sie uv run tox verwenden, um Tests auszuführen und den Codestil zu überprüfen.

Empfohlene Konfiguration:

uv sync --extra dev --extra tests --extra integtests --extra codestyle

Mit dem empfohlenen Setup werden Pakete zum Testen und zur Überprüfung des Codestils installiert, die es IDEs wie VsCode oder Cursor ermöglichen, den Code zu überprüfen oder während der Entwicklung Tests auszuführen.

Integrationstests

Um Integrationstests lokal auszuführen, verwenden Sie uv run tox -e integtests . HINWEIS: Sie müssen die folgenden Umgebungsvariablen festlegen:

  • INTEGTEST_STORAGE_API_URL

  • INTEGTEST_STORAGE_TOKEN

  • INTEGTEST_WORKSPACE_SCHEMA

Um diese Werte zu erhalten, benötigen Sie ein dediziertes Keboola-Projekt für Integrationstests.

Aktualisieren von uv.lock

Aktualisieren Sie die Datei uv.lock , wenn Sie Abhängigkeiten hinzugefügt oder entfernt haben. Erwägen Sie außerdem, die Sperre beim Erstellen einer Version mit neueren Abhängigkeitsversionen zu aktualisieren ( uv lock --upgrade ).

Support und Feedback

⭐ Die primäre Möglichkeit, Hilfe zu erhalten, Fehler zu melden oder Funktionen anzufordern, besteht darin, ein Problem auf GitHub zu öffnen . ⭐

Das Entwicklungsteam überwacht Probleme aktiv und reagiert schnellstmöglich. Allgemeine Informationen zu Keboola finden Sie in den unten stehenden Ressourcen.

Ressourcen

Verbinden

Available Tools

7 tools
get_bucket_metadataC

Get detailed information about a specific bucket.

ParametersJSON Schema
NameRequiredDescriptionDefault
bucket_idYesUnique ID of the bucket.

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the action but doesn't cover critical aspects like whether this is a read-only operation, potential rate limits, authentication needs, error handling, or what 'detailed information' entails. This leaves significant gaps for a tool that likely interacts with storage systems.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's purpose without unnecessary words. It's front-loaded and wastes no space, making it easy for an agent to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete. It doesn't explain what 'detailed information' includes, potential return formats, or behavioral traits like safety and performance. For a tool that likely provides metadata, more context is needed to guide effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, with the single parameter 'bucket_id' clearly documented. The description adds no additional meaning beyond the schema, such as format examples or constraints, but since the schema is comprehensive, a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Get' and the resource 'detailed information about a specific bucket', making the purpose understandable. However, it doesn't differentiate from sibling tools like 'list_bucket_info' or 'get_table_metadata', which likely serve related but distinct purposes, preventing a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With siblings such as 'list_bucket_info' and 'get_table_metadata' available, there's no indication of context, prerequisites, or exclusions, leaving the agent to guess based on names alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_table_metadataC

Get detailed information about a specific table including its DB identifier and column information.

ParametersJSON Schema
NameRequiredDescriptionDefault
table_idYesUnique ID of the table.

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool retrieves 'detailed information' but doesn't specify behavioral traits like whether it's read-only, requires specific permissions, has rate limits, or what happens if the table doesn't exist. This is a significant gap for a tool with no annotation coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that front-loads the core purpose. It avoids unnecessary words, though it could be slightly more structured by explicitly separating the tool's action from the information retrieved.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's moderate complexity (retrieving metadata for a specific table), no annotations, no output schema, and 100% schema coverage, the description is minimally adequate. It covers the basic purpose but lacks details on usage context, behavioral traits, and output format, leaving gaps in completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with the single parameter 'table_id' documented as 'Unique ID of the table.' The description adds no additional meaning beyond what the schema provides, such as format examples or constraints. With high schema coverage, the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with a specific verb ('Get detailed information') and resource ('about a specific table'), including what information is retrieved ('DB identifier and column information'). However, it doesn't explicitly differentiate from sibling tools like 'list_bucket_tables' or 'query_table', which prevents a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites, when not to use it, or how it differs from sibling tools such as 'list_bucket_tables' (which might list tables) or 'query_table' (which might query table data).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_bucket_infoB

List information about all buckets in the project.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states the action ('List information') but doesn't describe what 'information' includes, whether it's paginated, requires specific permissions, or has rate limits. This is a significant gap for a tool with zero annotation coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's purpose without any fluff or redundancy. It's appropriately sized and front-loaded, making it easy for an agent to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete. It doesn't specify what 'information' is returned, how results are formatted, or any behavioral traits like error handling. For a tool with no structured data support, this leaves too many unknowns for reliable agent use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters, and schema description coverage is 100%, so there's no need for parameter details in the description. The baseline for 0 parameters is 4, as the description doesn't need to compensate for any schema gaps.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('List') and resource ('information about all buckets in the project'), making the purpose immediately understandable. However, it doesn't explicitly differentiate from sibling tools like 'get_bucket_metadata' or 'list_bucket_tables', which might offer overlapping functionality.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'get_bucket_metadata' or 'list_bucket_tables'. There's no mention of prerequisites, context, or exclusions, leaving the agent to infer usage based on tool names alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_bucket_tablesC

List all tables in a specific bucket with their basic information.

ParametersJSON Schema
NameRequiredDescriptionDefault
bucket_idYesUnique ID of the bucket.

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states this is a list operation but doesn't mention whether it's paginated, rate-limited, requires specific permissions, or what format the 'basic information' returns. For a tool with zero annotation coverage, this leaves significant behavioral gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that gets straight to the point with no wasted words. It's appropriately sized for a simple list operation, though it could be slightly more front-loaded with key behavioral details given the lack of annotations.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete. It doesn't explain what 'basic information' includes, how results are structured, or any behavioral constraints. For a tool that presumably returns multiple items, this leaves the agent with insufficient context for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the input schema already documents the single 'bucket_id' parameter thoroughly. The description adds no additional parameter semantics beyond what's in the schema, meeting the baseline expectation when schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('List all tables') and target resource ('in a specific bucket'), providing a specific verb+resource combination. However, it doesn't distinguish this tool from sibling tools like 'list_bucket_info' or 'get_table_metadata', which might offer similar or overlapping functionality.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'list_bucket_info' or 'query_table'. It mentions 'basic information' but doesn't clarify what that includes or exclude compared to other tools, leaving the agent to guess about appropriate usage contexts.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_component_configsC

List all configurations for a specific component.

ParametersJSON Schema
NameRequiredDescriptionDefault
component_idYes

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. While 'List all configurations' implies a read operation, it doesn't address important behavioral aspects like pagination, rate limits, authentication requirements, error conditions, or what format the configurations are returned in. The description is minimal and lacks operational context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise - a single sentence that gets straight to the point with zero wasted words. It's appropriately sized for a simple listing tool and front-loads the essential information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no annotations, no output schema, and 0% schema description coverage, the description is inadequate. It doesn't explain what 'configurations' means in this context, what format they're returned in, whether there are limitations on what can be listed, or provide any operational context. The minimal description leaves too many questions unanswered.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage and 1 undocumented parameter, the description provides no additional semantic information about the 'component_id' parameter. It doesn't explain what constitutes a valid component ID, where to find component IDs, or provide any examples or constraints beyond what's minimally implied by the parameter name.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('List all configurations') and the target resource ('for a specific component'), providing a specific verb+resource combination. However, it doesn't differentiate this tool from its sibling 'list_components', which appears to list components rather than their configurations.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. There's no mention of prerequisites, when-not-to-use scenarios, or how this differs from sibling tools like 'list_components' or other metadata tools on the server.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_componentsB

List all available components and their configurations.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states the action ('List all available components and their configurations') but doesn't reveal critical traits like whether this is a read-only operation, potential rate limits, authentication needs, or what the output format entails. This leaves significant gaps for a tool with no structured safety hints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that front-loads the core action ('List all available components and their configurations') with zero waste. Every word serves a purpose, making it highly concise and well-structured for quick comprehension.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (0 parameters, no output schema, no annotations), the description is adequate as a basic overview. However, it lacks details on output format, behavioral constraints, and differentiation from siblings, which could be important for an agent to use it correctly in context with other tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters, and the schema description coverage is 100%, so there are no parameters to document. The description appropriately doesn't add unnecessary param details, earning a high baseline score for not overcomplicating a parameterless tool.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('List') and resource ('components and their configurations'), making the purpose immediately understandable. However, it doesn't distinguish this tool from its sibling 'list_component_configs', which appears to serve a similar function, preventing a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'list_component_configs' or other sibling tools. It lacks context about prerequisites, timing, or any explicit when/when-not instructions, leaving the agent with minimal usage direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

query_tableA
Executes an SQL SELECT query to get the data from the underlying snowflake database.
* When constructing the SQL SELECT query make sure to use the fully qualified table names
  that include the database name, schema name and the table name.
* The fully qualified table name can be found in the table information, use a tool to get the information
  about tables. The fully qualified table name can be found in the response for that tool.
* Snowflake is case-sensitive so always wrap the column names in double quotes.

Examples:
* SQL queries must include the fully qualified table names including the database name, e.g.:
  SELECT * FROM "db_name"."db_schema_name"."table_name";
ParametersJSON Schema
NameRequiredDescriptionDefault
sql_queryYesSQL SELECT query to run.

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It does well by specifying that this is for SQL SELECT queries only (implying read-only operations), mentioning Snowflake's case-sensitivity requirements, and providing implementation guidance about fully qualified table names. However, it doesn't address potential limitations like query timeouts, result size limits, or authentication requirements.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured and efficiently organized. It starts with the core purpose, then provides bulleted implementation guidance, and concludes with concrete examples. Every sentence serves a clear purpose without redundancy, making it easy for an AI agent to parse and apply the information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no annotations and no output schema, the description provides reasonable coverage of the execution behavior and requirements. However, it doesn't describe what the output looks like (result format, error responses), which is a significant gap given the absence of output schema. The description adequately covers the input requirements but leaves the output behavior unspecified.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage for the single parameter 'sql_query', the schema already documents this parameter adequately. The description adds some value by providing examples and formatting requirements (double quotes, fully qualified names), but doesn't significantly enhance the parameter understanding beyond what the schema provides. This meets the baseline expectation for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool 'executes an SQL SELECT query to get the data from the underlying snowflake database', which specifies the verb (executes), resource (SQL SELECT query), and target system (Snowflake database). However, it doesn't explicitly differentiate from sibling tools like get_table_metadata or list_bucket_tables, which appear to be metadata-focused rather than data retrieval tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context about when to use this tool - for executing SQL SELECT queries against Snowflake databases. It mentions prerequisites like using fully qualified table names and referencing table information from other tools, but doesn't explicitly state when NOT to use it or name specific alternatives among the sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 7 tool updatesv1.0.0
    • First observedget_bucket_metadata
    • First observedget_table_metadata
    • First observedlist_bucket_info
    • First observedlist_bucket_tables
    • First observedlist_component_configs
    • First observedlist_components
    • First observedquery_table

TDQS

A3.5/5.0

Scored across 7 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no overlap: get_bucket_metadata vs list_bucket_info (detail vs list), get_table_metadata vs query_table (metadata vs data retrieval), and list_bucket_tables vs list_components (bucket-specific vs component-focused). The descriptions reinforce these distinctions, making misselection unlikely.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern with snake_case: get_*, list_*, and query_* are used predictably throughout. The naming is uniform and readable, with no deviations in style or convention.

Tool Count5/5

With 7 tools, the count is well-scoped for a Keboola Explorer server focused on metadata retrieval and data querying. Each tool earns its place, covering buckets, tables, components, and queries without being overwhelming or too sparse.

Completeness4/5

The tool set provides strong coverage for exploration and querying in Keboola, with metadata listing and retrieval for buckets, tables, and components, plus data querying. A minor gap exists in write operations (e.g., creating or modifying resources), but agents can effectively navigate and query the environment with the available tools.

Maintenance

ActivityActive
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    This read-only MCP Server allows you to connect to Amazon S3 data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out the first managed MCP platform: CData Connect AI (https://www.cdata.com/ai/).
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    This read-only MCP Server allows you to connect to Google BigQuery data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out the first managed MCP platform: CData Connect AI (https://www.cdata.com/ai/).
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    This read-only MCP Server allows you to connect to Snowflake data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out the first managed MCP platform: CData Connect AI (https://www.cdata.com/ai/).
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    This read-only MCP Server allows you to connect to Google Cloud Storage data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out our MCP Server for Google Cloud Storage (https://www.cdata.com/drivers/googlecloudstorage/download/mcp).
    MIT