Metadata-Version: 2.4
Name: akko-mcp-trino-openmetadata
Version: 0.1.0
Summary: OpenMetadata context provider for akko-mcp-trino: descriptions, owners, tiers, PII classifications and keys, handed to the agent alongside the columns.
Author-email: Abderrahmen Dridi <contact@akko-ai.com>
Maintainer-email: AKKO <contact@akko-ai.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/AKKO-p/akko-mcp-trino/tree/main/providers/openmetadata
Project-URL: Repository, https://github.com/AKKO-p/akko-mcp-trino
Project-URL: Documentation, https://akko-ai.com/docs/akko-mcp-trino/
Keywords: mcp,trino,openmetadata,data-catalog,data-governance,ai-agents
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Database
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: akko-mcp-trino>=0.3.0
Requires-Dist: httpx>=0.28
Provides-Extra: dev
Requires-Dist: pytest==9.1.1; extra == "dev"
Requires-Dist: pytest-cov==7.1.0; extra == "dev"
Requires-Dist: ruff==0.16.7; extra == "dev"
Requires-Dist: mypy==2.3.1; extra == "dev"

# akko-mcp-trino-openmetadata

The [OpenMetadata](https://open-metadata.org) context provider for
[akko-mcp-trino](https://github.com/AKKO-p/akko-mcp-trino). It hands the agent
what the catalogue knows about a table — description, owners, tier, tags,
primary key as grain, foreign keys as joins, column descriptions and
classifications such as `PII.Sensitive` — alongside the columns Trino gives.

It reads metadata only, with a bot token. The data itself still flows through
Trino under the user's identity; knowing a column is PII changes nothing about
the mask the engine applies.

```bash
pip install akko-mcp-trino-openmetadata
export MCP_CONTEXT_PROVIDERS=openmetadata,trino-comments
export OPENMETADATA_URL=http://openmetadata:8585
export OPENMETADATA_TOKEN=<a bot token with read access>
export OPENMETADATA_SERVICE=<the database service name of your Trino in OpenMetadata>
akko-mcp-trino
```

| Variable | Meaning | Default |
|---|---|---|
| `OPENMETADATA_URL` | the OpenMetadata server | — |
| `OPENMETADATA_TOKEN` | a bot token; it needs read access to tables | — |
| `OPENMETADATA_SERVICE` | the name of the database service that catalogues your Trino (table FQNs are `service.catalog.schema.table`) | — |
| `OPENMETADATA_TIMEOUT_SECONDS` | per-request timeout | `5` |

An unknown table, a refused token or a catalogue that is down all mean
"nothing known": the agent gets Trino alone, never an error. One table fetch
serves all its columns for thirty seconds.

Apache 2.0. Part of the akko-mcp-trino repository (`providers/openmetadata`).
