# Preset MCP Discovery

> 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.

- Skill: `preset-io/preset-mcp-discovery` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add preset-io/preset-mcp-discovery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/preset-io/preset-mcp-discovery/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: preset-io (https://skillmd.com/u/preset-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/preset-io/preset-mcp-discovery

---


# 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

1. 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.
2. Otherwise list/search once for the object type in question.
3. Fetch details only for the specific object needed.
4. Route to `preset-mcp-data` for result rows, chart data, previews, or rendered SQL.
5. Route to mutation-focused skills before creating or updating objects.

## Retrieve

- Discovery tool map: [references/discovery-tools.md](references/discovery-tools.md)