Meridian — Trino control plane and MCP server for Kubernetes

Why Meridian

Everything your Trino platform is missing

⚡

Hot Standby Pool

Pre-provisioned clusters sit idle and are claimed instantly. No 30–90 second provisioning delay when a job needs a cluster.

🤖

MCP Server

19 tools for Claude Code, Claude Desktop, Cursor, and any MCP client. Follows the latest MCP spec (2026-07-28): one stateless /mcp endpoint that scales to many replicas. Older clients keep working.

☸️

Kubernetes Native

Three controllers, three CRDs, one Helm chart. Runs in any Kubernetes cluster. No external dependencies, no database, no sidecar.

🌐

Full REST API

Six mTLS-authenticated endpoints: list and filter clusters, get a cluster, list pools, scale replicas, reserve and release — all machine-to-machine.

📈

Auto-scaling

ClusterPoolAutoscaler watches reservation utilization and scales the pool up or down automatically with hysteresis.

🔒

Reservation TTL + Safety

Same clientId + reservationId always returns the same cluster. Crashed clients are handled automatically: reservations expire after a configurable TTL.

🛡️

Secure by Default

The MCP server requires a token and runs queries read-only. Tools that change clusters stay off until you enable them. The REST API uses mTLS, and pods run as non-root.

🔑

Credential Rotation

Rotate catalog credentials from Kubernetes Secrets, HashiCorp Vault, or AWS Secrets Manager. The catalog is swapped on the live cluster, with no restart.

🧪

Tested on Real Clusters

Every pull request installs the last release on Kubernetes, upgrades it, and runs 11 end-to-end scenarios with real Trino: queries, reservations, crashes, rotation, and rolling restarts.

Use cases

Not just for AI agents

⚙️

CI/CD Pipelines

Reserve a fresh cluster per test run, release on completion. No shared state, no flaky tests from cluster contention.

GitHub Actions · Jenkins

🔀

Workflow Orchestrators

Manage cluster lifecycle as a DAG task. Reserve before the job, release after — same as any other resource.

Airflow · Dagster · Prefect

🏠

Internal Developer Portals

Expose cluster provisioning to app developers through a form. No kubectl access required.

Backstage · Cortex

📦

Infrastructure as Code

Declare cluster pools as versioned resources alongside the rest of your infrastructure.

Terraform · Pulumi

Cluster lifecycle

From empty to reserved in seconds

State machine

Empty

→

Pending

→

Idle

→

Reserved

→

Idle

· pool returns cluster automatically

Failed

→ pool cleans up

Degraded

→ auto-recycled

MCP Tools

19 tools: 12 on by default, 7 you switch on

list_clusters

get_cluster

create_cluster

delete_cluster

reserve_cluster

release_cluster

scale_pool

list_pools

add_catalog

remove_catalog

list_catalogs

list_schemas

list_tables

get_table_schema

execute_query

explain_query

rotate_credentials

get_audit_log

promote_environment

On by default Changes clusters: turn on with --enable-tools

$ claude mcp add --transport http meridian https://<your-host>/mcp --header "Authorization: Bearer <token>"

Long-standing community requests

Meridian answers two open Trino issues

trinodb/trino #396 · open since 2019

Build a Kubernetes Operator for Trino

The most requested infrastructure feature in the Trino project. Meridian ships three controllers and three CRDs, fully open source.

trinodb/trino #26239 · open

Add an official MCP Server

Meridian ships 19 MCP tools covering the full operational surface — cluster lifecycle, catalogs, credentials, queries, and audit.

Docker Images

Two images. One control plane.

🤖
trino-mcp-serverMCP server for AI agents, Claude Desktop, and CI/CD pipelines.

        docker pull ghcr.io/meridian-io/trino-mcp-server:v1.4.1
      

☸️
trino-operatorKubernetes operator — manages the full Trino cluster lifecycle.

        docker pull ghcr.io/meridian-io/trino-operator:v1.4.1
      

Trino control plane and MCP server