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

# Tools

> Agents and Automations call provider operations as Tools without a Connection. Learn how to enable tools, read tool runs, and understand tool billing.

Tools are published provider operations that agents and Automations can call without a Connection. You don't need to authorize an account or expose anything to a Space first. An Organization Owner or Admin enables a tool once for the organization. After that, MCP clients and Automations can call it.

Use Tools when you need a ready-made operation, such as a lookup or a data request, from a provider your organization hasn't connected. To work with your own accounts and records in an external system, use [Connectors](https://flowglad.com/docs/connectors.md) instead.

## Who Can Manage Tools

Tools is available to every organization.

* **Organization Owners and Admins** see **Tools** in the main sidebar, directly below **Connectors**. They can discover tools across the full catalog and enable or disable them.
* **Other members** don't see the Tools page. Over MCP, they can discover and call tools that are already enabled, if their grant and permissions allow it.

Calling any tool requires command permission. When a call uses a Space, the caller also needs read access to that Space.

## Open the Tools Page

Select **Tools** in the main sidebar, or go to `/tools`. Older `/settings/tools` links redirect there.

The page has the same three tabs as **Connectors**, with a search field beside them:

| Tab | Shows |
| - | - |
| **Yours** | Enabled tools that you turned on. |
| **Organization** | Every tool enabled for your organization. This is the default tab. |
| **Discover** | All published tools, with categories beside the catalog. Tools that are already enabled show a check. |

Tools are grouped by provider. Select a provider to see its tools. Search matches tool titles and descriptions. Each tool card shows its price and whether the tool is read only.

Select a card to open the detail drawer. The drawer shows the tool's fields with **Overview** and **Schema** tabs. The **Schema** tab lists the tool's input fields. Open the tool's own page at `/tools/<toolId>` to see the **Overview**, **Schema**, and **Activity** tabs. That **Activity** tab lists only that tool's runs.

## Enable or Disable a Tool

1. Open **Tools** and select the **Discover** tab.
2. Find the tool and select its card.
3. In the drawer header, select **Enable Tool**.
4. Review the confirmation and select **Enable Tool** again.

To disable a tool, open it from the **Yours** or **Organization** tab, select **Disable Tool**, and confirm.

Enabling or disabling a tool applies to the whole organization, not to a single Space. Keep the following in mind:

* **Enabled tools update automatically.** When the provider publishes a new revision, enabled tools follow it. Saved runs keep the revision they executed.
* **Enabling doesn't guarantee a tool can run.** A tool's readiness can show **Not Ready · Pricing Unavailable** or **Not Ready to Execute**. Your organization also needs enough credits.
* **Disabling stops new calls only.** Runs that already started continue. Their history and billing remain available.

If Flowglad can't confirm a change, the change may still have been applied. Select **Refresh** to load the current state before you try again.

## Read Tool Runs

Tool runs from members and Automations are in **Settings** → **Audit Log**. Select the **Tool Runs** tab beside **Events**. It lists each run with its **Time**, **Tool**, **Executed Revision**, **Status**, and **Provider Billing**. Select a run to open its details, including usage evidence. Each run has a shareable link. Older **Activity** links redirect there.

| Status | Meaning |
| - | - |
| **Pending** | Flowglad admitted the run. It's being submitted or the provider is processing it. |
| **Submission Unknown** | Flowglad can't confirm whether the provider received the request. Don't start a replacement run. |
| **Insufficient Credits · Not Dispatched** | Your organization didn't have enough credits. Flowglad didn't send the request. |
| **Failed Before Dispatch** | The run stopped before Flowglad sent the request. |
| **Succeeded** | The provider returned a successful result. |
| **Provider Failed** | The run completed, but the provider or its output failed. |

## Understand Billing

A tool call has two separate charges:

* **Provider price.** Flowglad verifies the supplier's current rate and calculates a maximum for the request, including supplier fees. Flowglad chooses the lowest eligible live quote. If a cheaper listed offer is unavailable, another supplier can cost more than the listing estimate. The live maximum must fit available credits and any applicable spend cap. Flowglad reserves against the accepted quote, settles from the supplier receipt, and releases the unused amount. Some tools have no maximum that Flowglad can verify before the run. Their price shows as **Postpaid · Verified Supplier Amount**. Flowglad reserves nothing up front for them. After the run, Flowglad charges the full final amount the supplier verifies, even if that takes your credit balance below zero. Postpaid doesn't mean free.
* **Execution fee.** The ordinary MCP or Automation execution fee applies separately, the same as for any other MCP call or Automation run. See **Settings** → **Usage and Billing** for full accounting.

The **Provider Billing** column shows one of these states:

| State | Meaning |
| - | - |
| **Credits Reserved · Settlement Pending** | Flowglad is holding the maximum amount. This isn't a final charge. |
| **Postpaid · Settlement Pending** | The run is postpaid and Flowglad is waiting for the supplier's final amount. Nothing is held. |
| **Credits Charged** / **Credits Released** | The run is settled. Flowglad charged the actual amount and released the unused reservation. A settled postpaid run shows only **Credits Charged**. |
| **Direct Tool · No Provider Charge** | The tool has no provider charge. Execution fees still apply. |
| **Historical · Unbilled** | The run happened before provider billing applied to it. |
| **Billing Unavailable** | Billing information isn't available yet. This doesn't mean the run was free. |

A run with an uncertain submission can keep its reservation until Flowglad resolves it.

## Use Tools from an Agent

Agents connected through [MCP](https://flowglad.com/docs/mcp-server.md) can discover, manage, and call tools:

| MCP tool | Purpose |
| - | - |
| `tools.search` | Search tool summaries. Owners and Admins see all published tools. Other members see enabled tools only. |
| `tools.get` | Read a tool's current revision, input and output schemas, and pricing. |
| `tools.list_enabled` | List the enabled tools you can see. |
| `tools.enable` | Enable a tool for the organization. Requires an Owner or Admin and the `org:read` and `roles:write` grants. |
| `tools.disable` | Disable new calls to a tool for the organization. Has the same requirements as `tools.enable`. |
| `tools.execute` | Call an enabled tool at an exact revision. |
| `tools.get_run` | Read a saved run, including its status and provider billing. |

To call a tool, read its revision and input schema with `tools.get`, then call `tools.execute`:

```json theme={null}
{
  "name": "tools.execute",
  "arguments": {
    "format": 1,
    "toolId": "tool_...",
    "expectedRevision": "trev_...",
    "invocationKey": "repository-lookup-001",
    "arguments": { "owner": "example", "repo": "project" }
  }
}
```

Choose a unique `invocationKey` before the first call and keep it. If the response is lost, repeat the call with the same key, tool, revision, and arguments. Flowglad returns the existing run instead of starting a second one. If the response includes a run ID, poll it with `tools.get_run`. Treat a run as successful only when its result kind is `success`.

## Use Tools in Automations

Automations can call enabled tools. An Automation step declares each tool it uses by tool ID and exact revision, with limits on calls, run time, and data size. Flowglad checks that each tool is enabled and that the revision is current when the step runs. Tool runs from Automations appear in **Tool Runs** and use the same provider billing. If you disable a tool, Automations can't start new calls to it.


## Related topics

- [MCP](https://flowglad.com/docs/mcp-server.md)
- [Flowglad product updates](https://flowglad.com/docs/updates.md)
- [Automations](https://flowglad.com/docs/automations.md)
- [Concepts](https://flowglad.com/docs/agents/core-concepts.md)
- [Templates](https://flowglad.com/docs/templates.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.