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)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: preset-io
• Source: preset-io/agent-skills
• License: Apache-2.0
• Homepage: http://www.preset.io

Install and usage instructions live in the source repository linked above.