Synthetic tools - Firedrill

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 and route your agent to it. The tool is prepared when you apply the plan.
On its own. Start a tool session to explore a tool, connect a local agent to it or prepare data.

Find a tool

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:

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.

Tool sessions

Start a tool on its own and connect to it.

Connect synthetic tools

Route your agent’s calls in a drill.