Skip to main content
Glama
keboola

Keboola Explorer MCP Server

Keboola MCP 서버

AI 에이전트, MCP 클라이언트( Cursor , Claude , Windsurf , VS Code 등) 및 기타 AI 어시스턴트를 Keboola에 연결하세요. 데이터, 변환, SQL 쿼리 및 작업 트리거를 노출하세요. 글루 코드는 필요하지 않습니다. 에이전트가 필요로 하는 시점과 장소에 맞춰 적절한 데이터를 제공하세요.

개요

Keboola MCP Server는 Keboola 프로젝트와 최신 AI 도구를 연결하는 오픈 소스 브리지입니다. 스토리지 액세스, SQL 변환, 작업 트리거와 같은 Keboola 기능을 Claude, Cursor, CrewAI, LangChain, Amazon Q 등을 위한 호출 가능한 도구로 변환합니다.

Related MCP server: Google BigQuery MCP Server by CData

특징

  • 저장소 : 테이블을 직접 쿼리하고 테이블 또는 버킷 설명을 관리합니다.

  • 구성 요소 : 추출기, 작성기, 데이터 앱 및 변환 구성을 생성, 나열 및 검사합니다.

  • SQL : 자연어로 SQL 변환 생성

  • 작업 : 구성 요소 및 변환을 실행하고 작업 실행 세부 정보를 검색합니다.

  • 메타데이터 : 자연어를 사용하여 프로젝트 문서 및 개체 메타데이터를 검색, 읽기 및 업데이트합니다.

준비

다음 사항을 확인하세요.

  • [ ] Python 3.10+ 설치됨

  • [ ] 관리자 권한으로 Keboola 프로젝트에 액세스

  • [ ] 선호하는 MCP 클라이언트(Claude, Cursor 등)

참고 : uv 설치되어 있는지 확인하세요. MCP 클라이언트가 uv를 사용하여 Keboola MCP 서버를 자동으로 다운로드하고 실행합니다. uv 설치 :

macOS/리눅스 :

지엑스피1

윈도우 :

# 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

더 많은 설치 옵션을 보려면 공식 uv 문서를 참조하세요.

MCP 서버를 설정하기 전에 세 가지 주요 정보가 필요합니다.

KBC_저장_토큰

이는 Keboola의 인증 토큰입니다.

Storage API 토큰을 생성하고 관리하는 방법에 대한 지침은 공식 Keboola 문서를 참조하세요.

참고 : MCP 서버에 제한된 액세스 권한을 부여하려면 사용자 지정 스토리지 토큰을 사용하고, MCP가 프로젝트의 모든 항목에 액세스하도록 하려면 마스터 토큰을 사용하세요.

KBC_WORKSPACE_SCHEMA

이는 Keboola에서 작업 공간을 식별하며 SQL 쿼리에 필요합니다.

이 Keboola 가이드를 따라 KBC_WORKSPACE_SCHEMA를 얻으세요.

참고 : 작업 공간을 생성할 때 모든 프로젝트 데이터에 대한 읽기 전용 액세스 권한 부여 옵션을 선택하세요.

케불라 지역

Keboola API URL은 배포 지역에 따라 달라집니다. Keboola 프로젝트에 로그인했을 때 브라우저에서 URL을 확인하여 배포 지역을 확인할 수 있습니다.

지역

API URL

AWS 북미

https://connection.keboola.com

AWS 유럽

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

구글 클라우드 EU

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

구글 클라우드 미국

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

Azure EU

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

BigQuery 관련 설정

Keboola 프로젝트에서 BigQuery 백엔드를 사용하는 경우 KBC_STORAGE_TOKEN 및 KBC_WORKSPACE_SCHEMA 외에도 GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 설정해야 합니다.

  1. Keboola BigQuery 작업 공간으로 이동하여 자격 증명을 표시합니다(연결 버튼 클릭).

  2. 로컬 디스크에 자격 증명 파일을 다운로드하세요. 일반 JSON 파일입니다.

  3. 다운로드한 JSON 자격 증명 파일의 전체 경로를 GOOGLE_APPLICATION_CREDENTIALS 환경 변수로 설정합니다.

  4. 이렇게 하면 MCP 서버 인스턴스가 Google Cloud의 BigQuery 작업 공간에 액세스할 수 있는 권한이 부여됩니다. 참고 : KBC_WORKSPACE_SCHEMA는 BigQuery 작업 공간에서 데이터 세트 이름으로 불리며, 연결을 클릭하고 데이터 세트 이름을 복사하기만 하면 됩니다.

Keboola MCP 서버 실행

사용자의 요구 사항에 따라 Keboola MCP 서버를 사용하는 방법은 네 가지가 있습니다.

옵션 A: 통합 모드(권장)

이 모드에서는 Claude 또는 Cursor가 자동으로 MCP 서버를 시작합니다. 터미널에서 명령을 실행할 필요가 없습니다 .

  1. 적절한 설정으로 MCP 클라이언트(Claude/Cursor)를 구성하세요.

  2. 클라이언트는 필요할 때 자동으로 MCP 서버를 시작합니다.

클로드 데스크톱 구성

  1. Claude(화면 왼쪽 상단) -> 설정 → 개발자 → 구성 편집(claude_desktop_config.json이 보이지 않으면 생성하세요)으로 이동하세요.

  2. 다음 구성을 추가합니다.

  3. 변경 사항을 적용하려면 Claude 데스크톱을 다시 시작하세요.

{
  "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"
      }
    }
  }
}

참고 : BigQuery 사용자의 경우 다음 줄을 "env"에 추가하세요: {}: "GOOGLE_APPLICATION_CREDENTIALS": "/full/path/to/credentials.json"

구성 파일 위치:

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

  • 윈도우 : %APPDATA%\Claude\claude_desktop_config.json

커서 구성

  1. 설정 → MCP로 이동

  2. "+ 새로운 글로벌 MCP 서버 추가"를 클릭하세요.

  3. 다음 설정으로 구성하세요.

{
  "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"
      }
    }
  }
}

참고 : BigQuery 사용자의 경우 다음 줄을 "env"에 추가하세요: {}: "GOOGLE_APPLICATION_CREDENTIALS": "/full/path/to/credentials.json"

Windows WSL을 위한 커서 구성

Cursor AI를 사용하여 Linux용 Windows 하위 시스템에서 MCP 서버를 실행하는 경우 다음 구성을 사용하세요.

{
  "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'"
      ]
    }
  }
}

/wsl_path/to/keboola-mcp-server/.env 파일에 환경 변수가 포함되어 있는 경우:

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

옵션 B: 로컬 개발 모드

MCP 서버 코드 자체를 작업하는 개발자를 위해:

  1. 저장소를 복제하고 로컬 환경을 설정합니다.

  2. 로컬 Python 경로를 사용하도록 Claude/Cursor를 구성하세요.

{
  "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",

      }
    }
  }
}

참고 : BigQuery 사용자의 경우 다음 줄을 "env"에 추가하세요: {}: "GOOGLE_APPLICATION_CREDENTIALS": "/full/path/to/credentials.json"

옵션 C: 수동 CLI 모드(테스트 전용)

테스트나 디버깅을 위해 터미널에서 서버를 수동으로 실행할 수 있습니다.

# 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

참고 : 이 모드는 주로 디버깅이나 테스트용으로 사용됩니다. Claude나 Cursor를 사용하는 일반적인 경우에는 서버를 수동으로 실행할 필요가 없습니다.

옵션 D: 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

서버를 직접 시작해야 합니까?

대본

수동으로 실행해야 합니까?

이 설정을 사용하세요

Claude/Cursor 사용

아니요

앱 설정에서 MCP 구성

MCP를 지역적으로 개발

아니 (클로드가 시작함)

Python 경로로 구성 지정

CLI 수동 테스트

예

터미널을 사용하여 실행하세요

Docker 사용

예

도커 컨테이너 실행

MCP 서버 사용

MCP 클라이언트(Claude/Cursor)가 구성되고 실행되면 Keboola 데이터 쿼리를 시작할 수 있습니다.

설정 확인

모든 것이 제대로 작동하는지 확인하기 위해 간단한 쿼리부터 시작할 수 있습니다.

What buckets and tables are in my Keboola project?

당신이 할 수 있는 일의 예

데이터 탐색:

  • "고객 정보는 어떤 테이블에 저장되어 있나요?"

  • "매출 기준 상위 10개 고객을 찾는 쿼리를 실행하세요"

데이터 분석:

  • "지난 분기 지역별 판매 데이터를 분석해 주세요"

  • "고객 연령과 구매 빈도 간의 상관관계를 찾아보세요"

데이터 파이프라인:

  • "고객 테이블과 주문 테이블을 조인하는 SQL 변환을 만듭니다."

  • "Salesforce 구성 요소에 대한 데이터 추출 작업을 시작합니다."

호환성

MCP 클라이언트 지원

MCP 클라이언트

지원 상태

연결 방법

클로드(데스크톱 및 웹)

✅ 지원, 테스트됨

stdio

커서

✅ 지원, 테스트됨

stdio

윈드서핑, 제드, 리플리트

✅ 지원됨

stdio

코디움, 소스그래프

✅ 지원됨

HTTP+SSE

맞춤형 MCP 클라이언트

✅ 지원됨

HTTP+SSE 또는 stdio

지원되는 도구

참고: Keboola MCP는 1.0 이전 버전이므로 일부 주요 변경 사항이 발생할 수 있습니다. AI 에이전트는 새로운 도구에 자동으로 적응합니다.

범주

도구

설명

저장

retrieve_buckets

Keboola 프로젝트의 모든 스토리지 버킷을 나열합니다.

get_bucket_detail

특정 버킷에 대한 자세한 정보를 검색합니다.

retrieve_bucket_tables

특정 버킷 내의 모든 테이블을 반환합니다.

get_table_detail

특정 테이블에 대한 자세한 정보를 제공합니다

update_bucket_description

버킷 설명을 업데이트합니다.

update_column_description

테이블의 주어진 열에 대한 설명을 업데이트합니다.

update_table_description

테이블 설명을 업데이트합니다

SQL

query_table

사용자 정의 SQL 쿼리를 데이터에 대해 실행합니다.

get_sql_dialect

작업 공간에서 Snowflake 또는 BigQuery SQL 방언을 사용하는지 식별합니다.

요소

create_component_root_configuration

사용자 정의 매개변수를 사용하여 구성 요소 구성을 만듭니다.

create_component_row_configuration

사용자 정의 매개변수를 사용하여 구성 요소 구성 행을 만듭니다.

create_sql_transformation

사용자 정의 쿼리를 사용하여 SQL 변환을 생성합니다.

find_component_id

주어진 쿼리와 일치하는 구성 요소 ID 목록을 반환합니다.

get_component

ID가 주어진 특정 구성요소에 대한 정보를 가져옵니다.

get_component_configuration

특정 구성 요소/변환 구성에 대한 정보를 가져옵니다.

get_component_configuration_examples

특정 구성 요소에 대한 샘플 구성 예를 검색합니다.

retrieve_component_configurations

프로젝트에 존재하는 구성 요소의 구성을 검색합니다.

retrieve_transformations

프로젝트에서 변환 구성을 검색합니다.

update_component_root_configuration

특정 구성 요소 구성을 업데이트합니다.

update_component_row_configuration

특정 구성 요소 구성 행을 업데이트합니다.

update_sql_transformation_configuration

기존 SQL 변환 구성을 업데이트합니다.

직업

retrieve_jobs

상태, 구성 요소 또는 구성별로 작업을 나열하고 필터링합니다.

get_job_detail

특정 작업에 대한 포괄적인 세부 정보를 반환합니다.

start_job

구성 요소 또는 변환 작업을 실행하도록 트리거합니다.

선적 서류 비치

docs_query

자연어 쿼리를 기반으로 Keboola 문서를 검색합니다.

문제 해결

일반적인 문제

문제

해결책

인증 오류

KBC_STORAGE_TOKEN 이 유효한지 확인하세요

작업 공간 문제

KBC_WORKSPACE_SCHEMA 가 올바른지 확인하세요

연결 시간 초과

네트워크 연결 확인

개발

설치

기본 설정:

uv sync --extra dev

기본 설정으로 uv run tox 사용하여 테스트를 실행하고 코드 스타일을 확인할 수 있습니다.

권장 설정:

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

권장 설정을 사용하면 테스트 및 코드 스타일 검사를 위한 패키지가 설치되고, 이를 통해 VsCode나 Cursor와 같은 IDE에서 개발 중에 코드를 검사하거나 테스트를 실행할 수 있습니다.

통합 테스트

로컬에서 통합 테스트를 실행하려면 uv run tox -e integtests 사용하세요. 참고: 다음 환경 변수를 설정해야 합니다.

  • INTEGTEST_STORAGE_API_URL

  • INTEGTEST_STORAGE_TOKEN

  • INTEGTEST_WORKSPACE_SCHEMA

이러한 값을 얻으려면 통합 테스트를 위한 전담 Keboola 프로젝트가 필요합니다.

uv.lock 업데이트

종속성을 추가하거나 제거한 경우 uv.lock 파일을 업데이트하세요. 릴리스를 생성할 때 최신 종속성 버전으로 잠금을 업데이트하는 것도 고려해 보세요( uv lock --upgrade ).

지원 및 피드백

⭐ 도움을 받거나, 버그를 보고하거나, 기능을 요청하는 가장 기본적인 방법은 GitHub에서 이슈를 여는 것 입니다. ⭐

개발팀은 문제를 적극적으로 모니터링하고 최대한 빨리 대응하겠습니다. Keboola에 대한 일반적인 정보는 아래 자료를 참조하세요.

자원

연결하다

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