list_teams
Returns the teams the authenticated account belongs to. Use it when an account spans
more than one team and you need to disambiguate.
list_datasources
Returns the datasources a team has exposed. The usual first call in any session.
describe_datasource
Returns the exposed tables and columns for one datasource, along with the team’s own
notes about what they mean. Call this before writing SQL — the notes carry the context
that column names don’t.
sample_rows
Returns a small sample of rows from an exposed table. Cheaper than an exploratory
SELECT * and enough to see the shape of the data.
run_query
Runs a plain PostgreSQL SELECT. Anything outside the exposed tables and columns is
refused with an explanation.
Refusals describe what was blocked. Read the message and narrow the query — retrying
the same statement will fail the same way.