> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamduo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools

> The tools agents call against a TeamDuo datasource.

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

<Note>
  Refusals describe what was blocked. Read the message and narrow the query — retrying
  the same statement will fail the same way.
</Note>

## `search_docs`

Searches this documentation from inside an agent session, so an agent can answer setup
questions without leaving the client.