Each tool has a distinct purpose: listing all tables, describing one specific table, and executing read-only queries. There is minor overlap in that list_tables also returns columns, but the boundary between the three is clear enough that an agent can reliably pick the right one.

Names use a consistent snake_case verb_noun convention (describe_table, list_tables) with a uniform 'demo.' namespace prefix. demo.query is a slight deviation since it lacks a noun object, but it remains readable and clearly scoped.

Three tools is on the lean side but appropriate for a deliberately read-only demo database exploration surface. Each tool earns its place without redundancy.

List, describe, and query cover the core read-only exploration lifecycle with no dead ends, since arbitrary queries can retrieve counts, samples, and joins. A few conveniences (e.g., a schema-wide search or sample-row helper) are absent but easily worked around via query.