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

# Synthetic tools

> Synthetic versions of Gmail, Slack, Stripe, HubSpot, GitHub and other services, with their own data and state, for your agent to use in simulations.

A **synthetic tool** is a stand-in for a service your agent uses. It behaves like the real service and keeps its own data and state. Your agent can send email, post messages, refund payments or update a CRM without touching a real account. Every change is recorded as evidence, and many tools have a visual interface you can open in the web app.

## Use a synthetic tool

There are two ways:

* **In a drill.** Add the tool to a [world](https://docs.firedrill.run/build/worlds.md) and [route your agent to it](https://docs.firedrill.run/connect/tools.md). The tool is prepared when you apply the plan.
* **On its own.** Start a [tool session](https://docs.firedrill.run/tools/sessions.md) to explore a tool, connect a local agent to it or prepare data.

## Find a tool

```bash theme={null}
firedrill tools catalog
firedrill tools save <release-id>
firedrill tools runnable
```

`tools catalog` lists the tools published for your workspace. `tools save` adds one to your workspace. `tools runnable` lists saved versions and their services. In the web app, open **Tools** and choose **Select tool**.

## Services

Availability can change as new versions are published. `firedrill tools catalog` shows what you can use today.

| Service | Key | What it covers | Web preview |
| - | - | - | - |
| Gmail | `gmail` | A mailbox: messages, threads, labels, drafts, attachments and search | Yes |
| Slack | `slack` | Channels, direct messages, threads, reactions, pins and search | Yes |
| Google Calendar | `google-calendar` | Calendars, recurring events, invites and free/busy | Yes |
| Google Drive | `google-drive` | Folders, files, sharing, trash and changes | Yes |
| Google Sheets | `google-sheets` | Spreadsheets with formulas | Yes |
| Google Docs | `google-docs` | Documents, comments, revisions and export | Yes |
| Google Workspace | `google-workspace` | People, Workspace Events and Apps Script APIs | No |
| HubSpot | `hubspot` | Contacts, companies, deals, notes, tasks and pipelines | No |
| Salesforce | `salesforce` | Objects, upsert and SOQL queries | No |
| Attio | `attio` | Records, lists, notes and tasks | Yes |
| Stripe | `stripe` | Customers, payments, charges, refunds, invoices and subscriptions in test mode | Yes |
| QuickBooks Online | `quickbooks` | Customers, invoices, payments and queries | Yes |
| Xero | `xero` | Accounts, contacts, invoices, bills and payments | Yes |
| NetSuite | `netsuite` | Records and read-only SuiteQL | Yes |
| Check | `check` | Payroll: companies, employees, pay schedules and payrolls | Yes |
| Trolley | `trolley` | Payouts: recipients, batches and currency exchange | Yes |
| Notion | `notion` | Pages, databases, blocks, comments and search | Yes |
| Linear | `linear` | Teams, states, projects, cycles and issues | No |
| Jira Cloud | `jira` | Projects, issues, workflows and JQL | No |
| GitHub | `github` | Repositories, branches, commits, issues, pull requests and reviews | Yes |
| GitLab | `gitlab` | Projects, members, history, issues and merge requests | Yes |
| Datadog | `datadog` | Monitors, events, metrics, dashboards and incidents | Yes |
| Discord | `discord` | Servers, roles, channels, threads and messages | Yes |
| LinkedIn | `linkedin` | Posts, comments, reactions, organizations and profiles | Yes |
| Box | `box` | Folders, file versions, collaborations and search | No |
| Dropbox | `dropbox` | Files, revisions, folder listings and shared links | Yes |
| Documenso | `documenso` | E-signature documents, recipients, fields and templates | Yes |
| Resend | `resend` | Sending email, batches, scheduling and domains | Yes |
| Unified | `unified` | A unified CRM and messaging API | No |
| Unstructured | `unstructured` | Document partitioning and workflows | No |
| Waterfall | `waterfall` | Contact, phone and company enrichment and email checks | No |
| Web Corpus | `web-corpus` | A made-up public web with sites, search, pages and forms | No |

Synthetic tools never contact the real service. No email is delivered, no money moves and no real repository changes.

## HTTP and MCP

Your agent calls a service over HTTP or MCP, depending on what the tool version offers. Operation names follow the real API where possible, such as `messages.send` for Gmail or `refunds.create` for Stripe. To see a tool's services and operations before you save it:

```bash theme={null}
firedrill tools catalog-show <release-id>
firedrill tools catalog-operations <release-id> --service gmail
```

## Your own tools

If you depend on a service that is not listed, or on your own internal API, build a [custom tool](https://docs.firedrill.run/tools/custom-tools.md).

> [card] [Tool sessions](https://docs.firedrill.run/tools/sessions.md)
>
> Start a tool on its own and connect to it.

> [card] [Connect synthetic tools](https://docs.firedrill.run/connect/tools.md)
>
> Route your agent's calls in a drill.


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