Developer-tools MCP server
Apache Pinot MCP Server
Version history of discovered tools, schemas, and declared agent authority.
OBSERVED INTERFACE
Capability surface
Modelara’s observed declarations are shown separately from its derived effect classifications.
- 13
- 2
- 3
- 0
Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.
- Package
- mcp-pinot-server@5.0.0
- Registry
- pypi
- Published
- Oct 12, 2026
- Integrity
sha256-+unWJw6pCILWbzuApVkHwg2H4bqO8jzBzBKG2DRZH5Q=- Analyzer
- modelara v0.1.8 · policy not recorded
18 capabilities
| Capability | Type | Derived effect | First observed in Valyd coverage | Last changed |
|---|---|---|---|---|
begin_investigationstartreedata-mcp-pinot:tool:begin_investigationObserved interface and hashesOpen an owner-bound, budgeted evidence run using a server-owned profile. Supply closed baseline/incident windows in epoch milliseconds. The server checks scope, windows, and authorization before issuing an opaque run ID. Failure recovery: Correct invalid scope/window inputs; expired runs require a new investigation. Input schemasha256:dc2c712502a75e396d1aa6fad340345aef151f79ce1ec6fee922f2e15bed8f26Output schemasha256:2a75bab29441b6c0f5434e91b2eb5fc88c4cf8a4c32dc61043016b343095a568Description hash: Interface hash: Other observed Modelara metadata | tool | 5.0.0 | 5.0.0 | |
create_schemastartreedata-mcp-pinot:tool:create_schemaObserved interface and hashesPreview or create a new Pinot schema without replacing an existing schema. The default preview performs strict local structural validation and returns a short-lived confirmation token bound to the exact normalized schema. Pass that token with ``dry_run=false`` to apply. Replacement belongs in ``update_schema``. Failure recovery: Invalid JSON, missing ``schemaName``, and controller validation failures are non-retryable until corrected. Permission failures require access changes; retry transient controller failures only after connectivity is restored. Input schemasha256:b66d371d70c5b6233cf0e278451dfada1ed8fffb2137d2eeb5bd3d84e9271c3cOutput schemasha256:a1b69f42125d3d5beb369a44b6a20ebcbd0626d31fc6734368ec0f99995ac511Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
create_table_configstartreedata-mcp-pinot:tool:create_table_configObserved interface and hashesCreate a new Pinot table configuration. Accepts a typed table-config object. The default ``dry_run=true`` asks Pinot to validate the payload and returns a confirmation token without applying. Failure recovery: Invalid JSON, missing ``tableName``, and controller validation failures need a corrected payload; do not retry unchanged. Fix access failures first, and retry transient controller errors after connectivity is restored. Input schemasha256:8279e7612d04680a10d61d70d6004c2a45edbb898ffb837f3ed63618fe0ca1dfOutput schemasha256:a1b69f42125d3d5beb369a44b6a20ebcbd0626d31fc6734368ec0f99995ac511Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
finish_investigationstartreedata-mcp-pinot:tool:finish_investigationObserved interface and hashesClose a run once with authentic citations and an unverified outcome. Choose proposed for an adequately supported candidate association, abstained when adequate evidence shows healthy, unrelated, or confounded observations, and incomplete when missing, sparse, stale, partial, or failed evidence prevents evaluating the association. Complete SQL execution can still yield insufficient observations. Missing matched controls in otherwise adequate observations can reveal confounding and support abstention. Proposed requires a hypothesis; proposed/abstained require complete citations. Incomplete requires a reason. Pending work blocks finishing. These semantic choices are caller judgments; finishing validates ownership, citations, and execution completeness. Evidence sufficiency, the semantic choice, hypotheses, and dataset coverage remain unvalidated. Failure recovery: Correct citation/status errors; a closed run cannot be reused. Input schemasha256:0958bcd055785a9024a2b5a0f12d5fa1f1c04d98f0953582ace0a8fd581f38faOutput schemasha256:1f88423f6724433328c5be7286461cfcf3a7150c8880cea2b5b78f890188328cDescription hash: Interface hash: Other observed Modelara metadata | tool | 5.0.0 | 5.0.0 | |
get_schemastartreedata-mcp-pinot:tool:get_schemaObserved interface and hashesGet one Pinot schema, including dimensions, metrics, time, and primary keys. This is a single-object lookup, not a list, so pagination does not apply. The output preserves additional fields introduced by the connected Pinot version. Failure recovery: For not-found errors, pass the table's exact schema name (normally the table name without a type suffix). Fix permissions before retrying; retry transient controller failures after ``test_connection`` succeeds. Input schemasha256:c934a096b1b2d28df9c448fe6b9542beb42a63b90f55903a1d4ff85faaeef86eOutput schemasha256:80278d2648be22f3d849822e21d71d394a90507ee31eed84478c93155423fe68Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
get_segment_index_metadatastartreedata-mcp-pinot:tool:get_segment_index_metadataObserved interface and hashesGet per-column index metadata for ONE segment (which indexes each column has). Use this to inspect how a specific segment is indexed (inverted, sorted, range, etc.). Requires a ``segment_name`` from ``list_segments``. For a segment's row count/size/time boundaries use ``list_segment_metadata``; for the table's declared index *configuration* (not per-segment state) use ``get_table_config``. Failure recovery: A missing segment is non-retryable with the same value; refresh ``list_segments`` and use an exact returned name. Retry transient controller errors after ``test_connection`` succeeds. Input schemasha256:0f22b2a200956009e3390f15c297c8b9b073b7bba1c6d55e153fc3a573eaa1e3Output schemasha256:29d69a72436f8656feb28124dc0d9433d4ed5b1fab29428ddf1f3f9c7565d759Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
get_table_configstartreedata-mcp-pinot:tool:get_table_configObserved interface and hashesGet one table's indexing, retention, tenant, and ingestion configuration. This is a single-object lookup, not a list, so pagination does not apply. Set ``table_type`` only when one side of a hybrid table is needed. Failure recovery: For not-found errors, use an exact name from ``list_tables`` and a valid table type. Fix permissions before retrying; retry transient controller failures after ``test_connection`` succeeds. Input schemasha256:125c4da1d95a130456e44af9783c5c3ef80eab6fc5a62e3716961d1334fd509dOutput schemasha256:e5f61dffbb555564228473a3d7bbfb0800e2b3ec9e12cd98a9b06124f37be672Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
get_table_sizestartreedata-mcp-pinot:tool:get_table_sizeObserved interface and hashesGet a table's storage footprint: reported vs. estimated size in bytes. Use this for capacity/size questions about a whole table. It does NOT list segments (use ``list_segments``) or return row counts/time boundaries (use ``list_segment_metadata``). ``reportedSizeInBytes`` is what the servers currently hosting the segments report; ``estimatedSizeInBytes`` assumes every replica is present. Failure recovery: For not-found errors, copy an exact name from ``list_tables``. Fix permission errors before retrying; retry transient controller failures after a health check. Input schemasha256:0256e05eb420472dc0957050c35a7c59c5af11a4a6fdd4b0fab564b821760567Output schemasha256:9602a0818305d4b84b7d5206d848cce50877c3127d3c18d84261d72b98135675Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
get_tracestartreedata-mcp-pinot:tool:get_traceObserved interface and hashesRetrieve scoped trace rows with actual span and parent-span identifiers. Configure both span columns in the server profile. This fetches recorded relationships and does not infer causality or validate instrumentation coverage. Failure recovery: Use an exact scoped trace ID; inspect completeness before citing. Input schemasha256:cd031502e65ea53c2ff26463d480245662d3a9368460ab6aace9bc88aeb0a780Output schemasha256:1d300453ebb4e0e450a7f5bca955a522708ee5e109074efd3ef8845320ae2e4eDescription hash: Interface hash: Other observed Modelara metadata | tool | 5.0.0 | 5.0.0 | |
list_segment_metadatastartreedata-mcp-pinot:tool:list_segment_metadataObserved interface and hashesGet a deterministic page of segment rows, sizes, and time boundaries. Pinot can return thousands of segment objects. Results are sorted by exact segment name, then sliced with ``limit``/``offset``; follow ``has_more`` until false. Use ``list_segments`` when only names are needed. Failure recovery: An empty page is success. For not-found errors, use ``list_tables``; correct permissions before retrying, and retry transient server failures only after ``test_connection`` succeeds. Input schemasha256:2061de52db0b1e8836cfe14a2b55fd8adc8c0d77f1614c486431d36411fd27a1Output schemasha256:29f6a9239c498ad98e1bb4ad6df37bce8a8518a0a79ffd29a8bb63ddca7d0a9bDescription hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
list_segmentsstartreedata-mcp-pinot:tool:list_segmentsObserved interface and hashesList a table's segment names, grouped by table type (OFFLINE/REALTIME). Use this to discover segment names — e.g. to get a ``segment_name`` for ``get_segment_index_metadata``, or to see how a table is partitioned. For per-segment row counts / sizes / time boundaries call ``list_segment_metadata`` instead; for total storage call ``get_table_size``. Segment names are paginated (a busy table can have thousands) — use ``limit``/``offset`` and the ``has_more`` flag to page through them. Failure recovery: An empty page is success. For not-found errors, use an exact name from ``list_tables``; correct access errors, or retry transient controller errors. Input schemasha256:969a1c27d834b59e2d2f282b7ac54610f8469c4676b0013a95b38b36281ef5b8Output schemasha256:edae822623d44b9763770fdafbee0de8492af2c96b9d43712d33ee00464d3edcDescription hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
list_tablesstartreedata-mcp-pinot:tool:list_tablesObserved interface and hashesList Pinot tables visible to this server (subject to table filters). Returns a paginated list of table names. Use ``limit``/``offset`` and the ``has_more`` flag to page through clusters with many tables. Failure recovery: An empty page is success. For authentication/connectivity errors, verify the controller with ``test_connection`` and retry after access is restored. Input schemasha256:a6e18970fcfe5705962afb5a7c8a1cd599819d133ac34b227fd22ac391a00eb1Output schemasha256:c7f83bf44e4372c049c51605874a0dd5f79484b385243aa1b506dafa73a980e8Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
query_incidentstartreedata-mcp-pinot:tool:query_incidentObserved interface and hashesCollect bounded evidence with fixed tenant/time predicates and citations. The server generates SQL for the selected kind. Candidate filters apply only to onset queries. Failed, unknown, partial, truncated, or late execution is retained as incomplete evidence; it cannot support a qualified finish. Failure recovery: Query attempts consume budget even on failure. Inspect evidence before retrying. Input schemasha256:9f063b5f0c60297b4e40ed2c134350d38b1ea6fe206d333b8eb66e5bc1c4c588Output schemasha256:1d300453ebb4e0e450a7f5bca955a522708ee5e109074efd3ef8845320ae2e4eDescription hash: Interface hash: Other observed Modelara metadata | tool | 5.0.0 | 5.0.0 | |
read_querystartreedata-mcp-pinot:tool:read_queryObserved interface and hashesRun a read-only SQL query against Pinot and return a page of rows. Only a single SELECT (or WITH ... SELECT) statement is allowed; the query is rejected if it contains multiple statements or write/DDL/admin keywords. Results are paginated to keep responses small — use ``limit``/``offset`` and the ``has_more`` flag to page through large result sets. Returns ``QueryResult`` with the page of rows, the column list, fetched row count, a ``has_more`` flag, and native execution metadata. Missing native metadata is unknown; complete execution does not establish dataset coverage. Failure recovery: SQL/allow-list/permission failures require correcting the query or access; do not retry unchanged. A timeout or connection failure can be retried after ``test_connection`` succeeds. Check ``metadata.completeness`` even for zero rows; no response is promoted to healthy empty evidence. Input schemasha256:68838f59b806b5d24bce8753df1df7d63db6dcfc99e0cbebc762d6e92f546e90Output schemasha256:52b4c3ebee5060073f24ea77966eee096fdc0a426add82c465843f80e2a23d65Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
reload_table_filtersstartreedata-mcp-pinot:tool:reload_table_filtersObserved interface and hashesPreview or apply the configured table-filter YAML without restarting. Reads only the path configured by ``PINOT_TABLE_FILTER_FILE``. The YAML must be an object whose ``included_tables`` value is a non-empty list of glob strings. Allowing every table requires an explicit ``allow_all: true``. The default ``dry_run=true`` validates and reports the before/after patterns and returns a short-lived confirmation token. Pass ``dry_run=false`` with that token to apply the exact candidate atomically. Editing the file after preview invalidates the confirmation and requires another preview. Failure recovery: A missing setting/file or malformed YAML is non-retryable until corrected; fix ``PINOT_TABLE_FILTER_FILE`` or its ``included_tables`` list, then retry. Input schemasha256:ade387a46dd0fa396d6325da8e9169692151846f99468b8f5b91d838767cf6a9Output schemasha256:8b123baa985047722bf18b384f677327e2bb36acf1f33aedc0e7387b0f863719Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
test_connectionstartreedata-mcp-pinot:tool:test_connectionObserved interface and hashesProbe Pinot connectivity and return diagnostics. Runs three checks — broker connection, a trivial ``SELECT 1`` query, and a controller table listing — and reports which succeeded plus a small sample of tables. Useful for troubleshooting configuration before using other tools. Failure recovery: Individual check failures are returned in ``error``. Verify the broker and controller URLs, credentials, and network, then retry only failed checks. Input schemasha256:fc182e1a69a66dadc6c6ee98df9606d1d4fd90fb51b082083aaa8c230cb4765cOutput schemasha256:0c5fd06e357874b6f30a9ab1ebd359ed34f748a10dc94188ff005fb4d646e27bDescription hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
update_schemastartreedata-mcp-pinot:tool:update_schemaObserved interface and hashesUpdate an existing Pinot schema. Accepts a typed schema object. This can change column definitions on a live table; the default ``dry_run=true`` previews without applying and returns a confirmation token bound to the exact replacement. Failure recovery: Invalid JSON/name or schema validation failures require a corrected payload; do not retry unchanged. Fix permission errors first, and retry transient controller failures only after connectivity is restored. Input schemasha256:c1f5d043aeed4fd3eb8ffcbf2487f5df705a7f94e7d1857b9df8f295ff835048Output schemasha256:a1b69f42125d3d5beb369a44b6a20ebcbd0626d31fc6734368ec0f99995ac511Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 | |
update_table_configstartreedata-mcp-pinot:tool:update_table_configObserved interface and hashesUpdate an existing Pinot table configuration. Accepts a typed replacement table-config object. This changes a live table; the default ``dry_run=true`` asks Pinot to validate it, compares it with the current configuration, and returns a token without applying. Failure recovery: Invalid JSON/name or controller validation failures require a corrected payload; do not retry unchanged. Fix access errors first, and retry transient controller failures only after connectivity is restored. Input schemasha256:c06071a7f40701bd006d72c8f86eae7d86fb4277b413295620b7312463c171bdOutput schemasha256:a1b69f42125d3d5beb369a44b6a20ebcbd0626d31fc6734368ec0f99995ac511Description hash: Interface hash: Other observed Modelara metadata | tool | 4.0.0 | 5.0.0 |
No capabilities match these filters.
STATIC COMPARISONS
Release history
- 4.1.0 5.0.0REVIEW4 added0 removed1 schema0 write0 destructive0 unknown
- 4.0.0 4.1.0REVIEW0 added0 removed1 schema0 write0 destructive0 unknown