preset-mcp-discovery

Stars11

Forks2

UpdatedJune 11, 2026 at 15:40

Use Superset MCP health, instance, list, detail, schema, and chart-type discovery tools. Use only for MCP tool workflows; do not use for direct API work.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

preset-io

preset-io/agent-skills

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

2 files

SKILL.md

readonly

name	preset-mcp-discovery
description	Use Superset MCP health, instance, list, detail, schema, and chart-type discovery tools. Use only for MCP tool workflows; do not use for direct API work.

preset-mcp-discovery

Use for MCP metadata discovery that does not require result data or persistent changes.

Always

Use the single narrowest tool that answers the question; discovery calls are for missing IDs, names, or schemas — not a mandatory ladder.
Do not repeat an identical list call; reuse earlier results. Following pagination or refining a search filter when the target was not in the returned page is fine.
When a call fails on filter, sort, pagination, or request wrapper fields, fix it against the live tool schema rather than guessing again.
Do not expose hidden dataset, database, schema, or SQL details after permission errors.

Decision Rules

Use health_check and get_instance_info only when the user asks about service health or the workspace itself.
Use list_* tools once to find IDs when the identifier is missing; pick a page_size that covers the request in one call.
Use get_*_info for details of a specific known object.
Use get_schema only when a request fails or valid filter/sort/select fields are genuinely unknown.

Workflow Order

If the needed ID, UUID, slug, or other schema-accepted identifier is already known, skip listing and act on it. Resolve a bare display name with one list/search call.
Otherwise list/search once for the object type in question.
Fetch details only for the specific object needed.
Route to preset-mcp-data for result rows, chart data, previews, or rendered SQL.
Route to mutation-focused skills before creating or updating objects.

Retrieve

Discovery tool map: references/discovery-tools.md

More from this repository

same repository

preset-api

preset-io/agent-skills

Prepare direct Preset API access: auth, JWT exchange, base URLs, pagination, Rison parameters, response handling, and shared API setup. Use only for direct API workflows; Do not use for MCP-only work.

2026-06-2211

preset-dashboards

preset-io/agent-skills

Inspect Preset workspace dashboards, charts, dashboard composition, screenshots, thumbnails, chart data, and chart/dashboard operation routing through direct Superset API calls. Use only for direct API workflows; Do not use for MCP-only work.

2026-06-1211

preset-sql-execution

preset-io/agent-skills

Run or route SQL Lab execution, result retrieval, exports, query stop, saved-query mutation, and permalink workflows through direct Superset API calls. Use only for direct API workflows; Do not use for MCP-only work.

2026-06-1211

preset-cli

preset-io/agent-skills

Drive Preset's `sup` CLI (PyPI package `superset-sup`) for shell, scripting, CI/CD, and agent-driven Preset workflows. Use only for CLI workflows; Do not use for MCP-only work or for direct HTTP/SDK code paths.

2026-06-1211

preset-import-export

preset-io/agent-skills

Inspect and route direct Superset import/export workflows for dashboards, charts, datasets, databases, saved queries, themes, and asset bundles. Use only for direct API workflows; Do not use for MCP-only work.

2026-06-1111

preset-sqllab

preset-io/agent-skills

Inspect Preset SQL Lab bootstrap, query history, saved queries, result/export routing, query control, and SQL execution routing through direct Superset API calls. Use only for direct API workflows; Do not use for MCP-only work.

2026-06-1111

name	preset-mcp-discovery
description	Use Superset MCP health, instance, list, detail, schema, and chart-type discovery tools. Use only for MCP tool workflows; do not use for direct API work.

preset-mcp-discovery

Use for MCP metadata discovery that does not require result data or persistent changes.

Always

Use the single narrowest tool that answers the question; discovery calls are for missing IDs, names, or schemas — not a mandatory ladder.
Do not repeat an identical list call; reuse earlier results. Following pagination or refining a search filter when the target was not in the returned page is fine.
When a call fails on filter, sort, pagination, or request wrapper fields, fix it against the live tool schema rather than guessing again.
Do not expose hidden dataset, database, schema, or SQL details after permission errors.

Decision Rules

Use health_check and get_instance_info only when the user asks about service health or the workspace itself.
Use list_* tools once to find IDs when the identifier is missing; pick a page_size that covers the request in one call.
Use get_*_info for details of a specific known object.
Use get_schema only when a request fails or valid filter/sort/select fields are genuinely unknown.

Workflow Order

If the needed ID, UUID, slug, or other schema-accepted identifier is already known, skip listing and act on it. Resolve a bare display name with one list/search call.
Otherwise list/search once for the object type in question.
Fetch details only for the specific object needed.
Route to preset-mcp-data for result rows, chart data, previews, or rendered SQL.
Route to mutation-focused skills before creating or updating objects.

Retrieve

Discovery tool map: references/discovery-tools.md