An MCP server that interacts with Iceberg tables.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"iceberg-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
<div align="center"> <!-- omit in toc --> <img src="assets/iceberg-logo.svg" alt="Iceberg Logo" /> # IcebergMCP 🚀 <strong>AI-native Lakehouse Integration</strong> [](https://pypi.org/project/iceberg-mcp) [](https://github.com/ryft-io/iceberg-mcp/blob/main/LICENSE) </div> IcebergMCP is a [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that lets you interact with your [Apache Iceberg™](https://iceberg.apache.org/) Lakehouse using natural language in Claude, Cursor, or any other MCP client. <video src="https://github.com/user-attachments/assets/907180f3-27ad-401a-9fa0-f3178cd290de"></video> <!-- omit in toc --> ## Table of Contents - [Installation](#installation) - [Prerequisites](#prerequisites) - [Claude](#claude) - [Cursor](#cursor) - [Configuration](#configuration) - [Available Tools](#available-tools) - [Examples](#examples) - [Limitations & Security Considerations](#limitations--security-considerations) - [Contributing](#contributing) ## Installation ### Prerequisites - Apache Iceberg™ catalog managed in AWS Glue - AWS profile configured on the machine, with access to the catalog - `uv` package manager - install via `brew install uv` or see [official installation guide](https://docs.astral.sh/uv/getting-started/installation/) ### Claude 1. Inside Claude, go to Settings > Developer > Edit Config > claude_desktop_config.json 2. Add the following: ```json { "mcpServers": { "iceberg-mcp": { "command": "uv", // If uv can't be found, replace with full absolute path to uv "args": [ "run", "--with", "iceberg-mcp", "iceberg-mcp" ], "env": { "ICEBERG_MCP_PROFILE": "<aws-profile-name>" } } } } ``` ### Cursor 1. Inside Cursor, go to Settings -> Cursor Settings -> MCP -> Add new global MCP server 2. Add the following: …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.