---
title: What can an AI assistant do in Tacey? Every tool, what it reads or changes, and which ones can move money
description: A table of all 45 tools an AI assistant can use in Tacey: what each one does, whether it only reads, changes something, or can move money, and what you have to approve first. ChatGPT and Claude can use all 45 (writes and money only when you have allowed them); Sidekick uses only 18 of the read tools.
canonical: https://tacey.app/docs/settings-and-configuration/every-tool-an-ai-assistant-can-use-in-tacey
updated: 2026-11-16T11:12:12.073Z
---
# What can an AI assistant do in Tacey? Every tool, what it reads or changes, and which ones can move money

When you connect ChatGPT or Claude to Tacey, or ask Sidekick about Tacey, the assistant works through a fixed list of tools. A tool is one thing the assistant is allowed to do. There are 45 in all. ChatGPT and Claude can use any of them that the connection's permissions and your switches allow. Sidekick uses only 18 of the read tools. Most tools only read your records. A few change something, and only when you have switched that action on. Six deal with money, and they have their own page: [How does an AI assistant move money in Tacey, and what do I have to confirm?](/docs/settings-and-configuration/how-does-an-ai-assistant-move-money-in-tacey)

If you have not connected an assistant yet, start with [Use Tacey from Claude or ChatGPT](/docs/settings-and-configuration/use-tacey-from-claude-or-chatgpt) and the step-by-step pages for [ChatGPT](/docs/settings-and-configuration/connect-chatgpt-to-tacey-step-by-step) and [Claude](/docs/settings-and-configuration/connect-claude-to-tacey-step-by-step).

## In short

- **Read tools (27).** They look something up and change nothing. They need only the read permission.
- **Preview tools (3).** `prepare_order_action`, `prepare_address_change` and `prepare_settings_change` show what an action would do. They change nothing.
- **Change tools (15).** Each makes one change. Each needs its own permission on the connection **and** its own switch turned on in Tacey, and each works only from a preview made in the last 10 minutes (5 minutes for money), once.
- **Six of the change tools deal with money.** Three can move money. Three only record that you handled it in Shopify. See the money page.
- **Tacey does not send a customer's name, email or phone back through any of these tools.** Each tool returns a fixed set of fields, such as order numbers, statuses, reasons, counts and links. Anything you type into the chat yourself, such as a unit number, is in the chat and is visible to the assistant.

## Before you start

- Connect an assistant first: Tacey, then **Integrations**.
- To let an assistant change anything, tick the matching permission when you connect it, **and** switch the action on under **Integrations** in Tacey. A permission without the switch does nothing, and a switch without the permission does nothing.
- AI changes are off for the store until both are done. The platform also has its own master switch for changes and a separate one for money. If the one for changes is off, the assistant is told assistant actions are "not available yet"; if the one for money is off, it is told moving money from an assistant is not available. Either way the tool is not listed.
- The directory version of the connector (the address the app directories use) is read only. It never lists a change tool or a money tool.

## How to use it

Ask in plain words. The assistant picks the tool. For anything that changes something, the assistant first shows a preview, you say yes, and only then does the change run. Where you chose to approve address changes or merges in Tacey instead of in the chat, the tool answers with a link to Tacey and changes nothing until you press the button there. If you want the assistant to point you to a page instead, ask it to open the page in Tacey.

## The tools

### Read tools: look something up

| Tool | What it does | Changes anything? |
|---|---|---|
| `get_unverified_orders` | Lists orders whose address check needs attention, newest first, up to 10 | No |
| `get_order_validation_detail` | Explains the address check on one order in plain sentences | No |
| `get_validation_analytics` | Counts address checks by status and country, optionally for a date range | No |
| `get_order_edit_history` | Shows what Tacey recorded changing on one order, up to 10 changes | No |
| `get_pending_money_actions` | Lists orders where money is waiting on you: stuck refunds, balances owed, held payments | No |
| `get_ledger_summary` | Counts order edits and totals the money Tacey collected or refunded through them | No |
| `get_order_merge_history` | Lists merges Tacey made or tried, with their status | No |
| `get_plan_and_usage` | Shows your Tacey plan, order usage in the current 30 days and your trial | No |
| `get_edit_breakdown` | Breaks edits down by country, kind of edit or who made them | No |
| `get_dashboard_overview` | Gives the Tacey Home numbers for a period | No |
| `list_orders` | Lists the orders Tacey has checked, like the Orders page, with filters | No |
| `get_order_overview` | Gives everything Tacey stored about one order: address check, changes, money waiting, merge, holds | No |
| `list_order_changes` | Lists what changed after checkout, like the Order changes page | No |
| `get_setup_health` | Lists what is switched on but cannot work, and what needs attention | No |
| `get_tool_settings` | Shows how the shopper tools are set up | No |
| `get_app_settings` | Shows one settings area: edit window, validation, holds, payments, merge, combine, reminders or notifications | No |
| `list_editing_rules` | Lists your rules and whether each can fire | No |
| `list_fulfillment_holds` | Lists orders Tacey is holding back from fulfilment and when each ends | No |
| `get_assistant_activity` | Lists connected assistants and what each has read in the last 30 days | No |
| `get_tacey_link` | Returns a link to a page in Tacey | No |
| `get_analytics_report_link` | Returns a link to an analytics report with filters already set | No |
| `list_merchant_notifications` | Lists what is in your notification bell | No |
| `list_shopper_feedback` | Lists the ratings customers gave after editing | No |
| `search_help_articles` | Finds up to 3 published help articles for a how-to question | No |
| `list_merge_candidates` | Lists pairs of orders that fit your merge conditions today. It reads Shopify live and can take several seconds | No |
| `list_buyer_requests` | Lists customer requests to remove items, still waiting for your answer | No |
| `list_setting_changes` | Lists the settings an AI assistant changed on your store, with before and after values | No |

### Preview tools: show what would happen

| Tool | What it does | Changes anything? |
|---|---|---|
| `prepare_order_action` | Previews one action on an order (re-check an address, merge two orders, apply a suggested address, ask a customer to fix or pay, place or release a hold) or a money step. Returns what it will and will not change and a proposal valid for 10 minutes, once | No |
| `prepare_address_change` | Previews setting parts of one order's shipping address, for example the unit number | No |
| `prepare_settings_change` | Previews changing one Tacey setting | No |

### Change tools: make one change, after your approval

| Tool | What it does | Needs |
|---|---|---|
| `recheck_address` | Runs the address check again on one order and stores the new result | Re-check permission and switch, a preview from `prepare_order_action` |
| `apply_suggested_address` | Applies the correction Tacey's check found and confirmed for one order | Address permission and switch, a preview |
| `change_shipping_address` | Sets parts of one order's address to the values you gave, as shown by `prepare_address_change` | Address permission and switch, a preview, used once within 10 minutes |
| `merge_orders` | Merges two orders of one customer that ship to the same address and fit your merge conditions: the older order is kept and gains the newer order's items at no charge, and the newer order is cancelled without a refund | Merge permission and switch, a preview |
| `ask_customer_to_fix` | Prepares the email asking the customer to fix a flagged address. **It does not send it:** it waits on the order in Tacey for you to press Send | Contact permission and switch, a preview |
| `ask_customer_to_pay` | Prepares the email asking the customer to pay a balance after an edit. It waits for you to press Send | Contact permission and switch, a preview |
| `place_fulfillment_hold` | Holds one order's fulfilment in Shopify until a time you choose, at most 72 hours ahead. A warehouse or app that reads orders directly instead of waiting for Shopify's fulfilment request may still pick the order up | Hold permission and switch, a preview |
| `release_fulfillment_hold` | Releases a hold an assistant placed. It never releases your own hold | Hold permission and switch, a preview |
| `change_setting` | Changes the one setting `prepare_settings_change` described, to exactly that value, only if the setting still has the value it had at the preview. An assistant can only move a setting toward less risk (customers can do less, fewer emails go out, fewer orders are touched). A change the other way, and any setting about money, customer-facing words, who sees what or notification addresses, is left for you in Tacey | Settings permission and switch, you approve in the chat |
| `approve_refund`, `confirm_merge_shipping_refund`, `capture_payment` | **Move money.** See the money page | Money permission, typed-back amount, see the money page |
| `record_manual_refund`, `resolve_cancel_refund`, `acknowledge_swap_balance` | **Record only.** They note that you handled something in Shopify. They move no money | Money permission, see the money page |

## What you will see

- The assistant answers in its own words and gives order numbers and links that open in Tacey.
- An address change or merge you approved, and a money step, is written to the order's change history in Tacey with the assistant named, and a setting change appears in **Settings changes**.
- **Integrations** shows the connections, and `get_assistant_activity` lists what each has read.

## If it does not work

**The assistant says a tool is not available.**
Three different things produce this, and the assistant's message says which. "Not available yet" means the platform switch for changes is off, and a message that moving money from an assistant is not available means the platform switch for money is off. "Needs more permission" means the connection was made without the matching permission: disconnect and connect again, ticking it. "Switched off" means the action's switch under **Integrations** in Tacey is off.

**The assistant says my preview ran out.**
A preview lasts 10 minutes (5 for money) and works once. Ask for the action again.

**The email it prepared did not go out.**
That is by design. `ask_customer_to_fix` and `ask_customer_to_pay` only prepare the email. Open the order in Tacey and press Send.

**It changed a setting I did not expect.**
Open the list of settings changes: ask the assistant to run `list_setting_changes`, or open it in Tacey. It shows the value before and after and which assistant changed it.

## Still stuck?

Contact Tacey support from the chat bubble inside the Tacey app, or email hello@taceysupport.app. Tell us which assistant you use, the tool name if the assistant gave it, and the message it showed.

## Learn more

- [Use Tacey from Claude or ChatGPT](/docs/settings-and-configuration/use-tacey-from-claude-or-chatgpt)
- [What does each Tacey error code mean?](/docs/how-tacey-works/what-every-tacey-error-code-means)

## What this does not do

- Tacey does not send a customer's name, email address or phone back through these tools. What you type into the chat yourself is in the chat.
- An assistant cannot change anything you have not switched on, and cannot move money unless you have also given it the money permission within the last 24 hours and the other conditions on the money page are met.
- An assistant cannot release a hold you placed yourself.
- The preview tools change nothing.
