# Tools reference

The tools the Floqer MCP server exposes to a connected assistant, grouped by what they act on. Tools fall into three roles:

- **Read** tools (`list_*`, `get_*`, `read_*`) inspect your workspace and never change anything, they are safe to call freely.
- **Run** tools (`run_*`) execute automations and consume credits, just like clicking Run in the app.
- **Write** tools (`manage_*`, `set_*`, `add_*`, `configure_*`) create or change workspace objects.

Start every session with **`get_started`**, which returns the operating context (workflow, tool roles, cost-safety rules, known gotchas) and should be called before any other Floqer tool.

## 1. Session and account

| Tool | Role | What it does |
| --- | --- | --- |
| `get_started` | Read | Returns the current operating context for the workspace. Call first, on every new task. |
| `get_user` | Read | Returns the authenticated user and workspace the token belongs to. |

## 2. Workflows

| Tool | Role | What it does |
| --- | --- | --- |
| `list_workflows` | Read | Lists the workflows in the workspace. |
| `get_workflow` | Read | Returns a single workflow's configuration. |
| `get_workflow_actions` | Read | Returns the actions (steps) that make up a workflow. |
| `add_action` | Write | Adds an action to a workflow. |
| `configure_action` | Write | Sets or updates the configuration of an action. |
| `manage_workflow` | Write | Creates, updates, or changes the state of a workflow. |
| `run_workflow` | Run | Executes a workflow. Consumes credits. |

## 3. Apps

Apps are packaged, runnable Floqer automations.

| Tool | Role | What it does |
| --- | --- | --- |
| `list_apps` | Read | Lists available apps. |
| `get_app` | Read | Returns a single app's details. |
| `run_app` | Run | Runs an app. Consumes credits. |
| `get_app_run` | Read | Returns the result and status of a specific app run. |
| `list_app_runs` | Read | Lists prior runs of an app. |

## 4. Sources and tables

Sources feed data in; tables (rows) hold the working data a workflow reads and writes.

| Tool | Role | What it does |
| --- | --- | --- |
| `list_sources` | Read | Lists the data sources in the workspace. |
| `get_source_data` | Read | Reads data from a source. |
| `manage_source` | Write | Creates or updates a data source. |
| `list_rows` | Read | Reads rows from a table. |
| `manage_rows` | Write | Adds, updates, or removes rows. |

## 5. Inputs

Inputs are the parameters a workflow or app expects before it runs.

| Tool | Role | What it does |
| --- | --- | --- |
| `list_inputs` | Read | Lists the inputs an object expects. |
| `manage_inputs` | Write | Sets or updates input values. |

## 6. Docs

| Tool | Role | What it does |
| --- | --- | --- |
| `list_docs` | Read | Lists the docs available in the workspace. |
| `read_doc` | Read | Returns the contents of a doc. |

> The exact tool set can grow over time. Ask the assistant to list its available Floqer tools, or call `get_started`, to see what your workspace currently exposes.
