MCP tools
Every tool needs the ghostpull scope; tools that spend credits also need
spend_credits, and the assistant asks you to approve the price first.
The assistant reads each tool's inputs and outputs from the server.
| Tool | What it does | Extra scope |
|---|---|---|
get_current_user | Get the logged-in user | |
update_current_user | Set the user's display name | |
list_addons | List the account's available Addons | |
get_addon_settings | Get the settings saved for an Addon | |
save_addon_settings | Save settings for an Addon's later runs | |
reset_addon_settings | Reset an Addon's settings to its defaults | |
list_media_assets | List the media library | |
get_media_asset | Get one asset | |
list_catalogs | List the account's product catalogs | |
list_products | List and search the account's products | |
get_product | Get a product with its variants, images and linked assets | |
create_catalog | Create a product catalog | |
create_product_import | Create a product file import | |
import_product_file_from_url | Import a product file from a URL | |
read_product_import | Read an uploaded product file | |
get_product_import | Get a product import | |
start_product_import | Import a read file's products into a catalog | |
link_product_asset | Link a library asset to a product or one of its variants | |
unlink_product_asset | Unlink an asset from a product or one of its variants | |
create_product | Make a product in a catalog without a shop system | |
update_product | Change a product made in Ghostpull | |
start_brand_analysis | Analyze a shop's brand from its web address | |
get_brand_analysis | Read a brand analysis | |
approve_brand_analysis | Approve a brand analysis as the shop's brand | |
list_brands | List the account's brands | |
get_brand | Read a brand | |
update_brand | Edit a brand | |
set_default_brand | Make a brand the account's default | |
attach_brand_font | Set a brand's heading or body font file | |
import_google_brand_font | Use a Google font as a brand's heading or body font file | |
delete_brand | Delete a brand | |
start_media_upload | Start uploading a file to the media library | |
complete_media_upload | Finish an upload to the media library | |
start_orchestrator_run | Run an Addon's Workflow | spend_credits |
get_billing_balance | Get the account's credits | |
get_billing_catalog | List the plans and credit packs an account can buy | |
get_billing_subscription | Get the account's plan subscription | |
start_billing_checkout | Start subscribing to a plan | |
start_credit_pack_checkout | Start buying a credit pack | |
list_orchestrator_runs | List your runs | |
get_orchestrator_run | Get a run's status and outputs | |
redo_orchestrator_run | Make a finished run again with a note | spend_credits |
list_running_orchestrator_runs | List the runs that are running now | |
start_orchestrator_batch | Run an Addon on a set of items | spend_credits |
get_orchestrator_batch | Get a batch's items and their results | |
cancel_orchestrator_batch | Cancel a batch | |
retry_orchestrator_batch | Retry a batch's failed items | spend_credits |
redo_orchestrator_batch | Make finished items of a batch again with a note | spend_credits |
set_orchestrator_batch_item_version | Choose which version a redone batch item shows | |
list_orchestrator_batches | List your batches | |
get_help | Read the help documents | |
create_support_case | Report a problem, a wish or an unanswered question | |
list_support_cases | List support cases (admins) | |
get_support_case | Read a support case (admins) | |
reply_to_support_case | Answer a support case (admins) | support_admin |
set_support_case_status | Close, reopen or export a support case (admins) | support_admin |
get_model_call_costs_per_addon | Model call costs per Addon and period (admins only) | support_admin |
list_model_call_costs_per_run | Model call costs per run in a period (admins only) | support_admin |
list_support_proposals | List proposals for changes (admins) | support_review |
create_support_proposal | Propose a change from support cases (admins) | support_review |
set_support_proposal_status | Export, reject or reopen a proposal (admins) | support_review |
import_chat_file | Import files attached in ChatGPT | |
show_media_upload | Let the user upload photos | |
show_media_picker | Let the user pick photos from their Media library | |
import_chat_product_file | Import a product file attached in ChatGPT | |
show_choices | Let the user pick from a planning run's choices | |
show_product_import | Let the user import a product file |