MCP Pinot MCP Server

It allows you to - List tables, segments, and schema info from Pinot - Execute read-only SQL queries - View index/column-level metadata - Designed to

Remote serverstreamable-httpPython

What is the MCP Pinot MCP server?

Connect MCP Pinot to Claude, Cursor or any other MCP client and it stops being a tab you switch to. It allows you to - List tables, segments, and schema info from Pinot - Execute read-only SQL queries - View index/column-level metadata - Designed to assist business users via Claude integration - and much more. The mcp pinot mcp server is what makes that connection.

What the server does

  • Every tool advertises typed input and output JSON Schemas, MCP risk annotations,
  • Large query, table, segment-name, and segment-metadata responses use bounded
  • Read-only SQL is parsed and enforced before execution; validation, permission,
  • Every mutating tool supports dry_run; always preview the exact target and
  • Single-purpose schema and table-config inspection tools avoid ambiguous combined

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Prerequisites — The Prerequisites tool exposed by this server
  • Installation — The Installation tool exposed by this server
  • Authentication — An auth provider is required before binding HTTP or HTTPS to a non-loopback host
  • Setup — Copy the example configuration file: bash cp table_filters.yaml.example table_filters.yaml
  • Build — The Build tool exposed by this server
  • Test — Test the repo with: bash uv run pytest --cov=mcp_pinot

Installation

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

Credentials and setup notes

Configuration is passed through the environment: PINOT_CONTROLLER_URL, PINOT_BROKER_URL, PINOT_BROKER_HOST, PINOT_TOKEN, MCP_STATIC_TOKEN, OAUTH_CLIENT_ID, OAUTH_CLIENT_SECRET, OAUTH_BASE_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Where it fits

This sits in the database access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. MCP Pinot's toolset — Prerequisites, Installation, Authentication and 3 more — is a fair guide to whether it matches your workflow. It is maintained by startreedata; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against MCP Pinot's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
PrerequisitesThe Prerequisites tool exposed by this server.
InstallationThe Installation tool exposed by this server.
AuthenticationAn auth provider is required before binding HTTP or HTTPS to a non-loopback host.
SetupCopy the example configuration file: bash cp table_filters.yaml.example table_filters.yaml
BuildThe Build tool exposed by this server.
TestTest the repo with: bash uv run pytest --cov=mcp_pinot

How to install the MCP Pinot MCP server

### Add an MCP server entry
```json
{
  "mcpServers": {
      "pinot_mcp": {
          "command": "/path/to/uv",
          "args": [
              "--directory",
              "/path/to/mcp-pinot-repo",
              "run",
              "mcp_pinot/server.py"
          ],
          "env": {
            // You can also include your .env config here
          }
      }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
PINOT_CONTROLLER_URLEndpoint or connection string the server talks to.Yes
PINOT_BROKER_URLEndpoint or connection string the server talks to.Yes
PINOT_BROKER_HOSTEndpoint or connection string the server talks to.Optional
PINOT_TOKENCredential the server authenticates with.Yes
MCP_STATIC_TOKENCredential the server authenticates with.Yes
OAUTH_CLIENT_IDConfiguration value read at startup.Optional
OAUTH_CLIENT_SECRETCredential the server authenticates with.Yes
OAUTH_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use MCP Pinot to Prerequisites.
  • Use MCP Pinot to Installation.
  • Use MCP Pinot to Authentication.

Frequently asked questions

It connects MCP Pinot to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (Prerequisites, Installation, Authentication, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP Pinot directly.