Skip to main content

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.

ToolWhat it doesExtra scope
get_current_userGet the logged-in user
update_current_userSet the user's display name
list_addonsList the account's available Addons
get_addon_settingsGet the settings saved for an Addon
save_addon_settingsSave settings for an Addon's later runs
reset_addon_settingsReset an Addon's settings to its defaults
list_media_assetsList the media library
get_media_assetGet one asset
list_catalogsList the account's product catalogs
list_productsList and search the account's products
get_productGet a product with its variants, images and linked assets
create_catalogCreate a product catalog
create_product_importCreate a product file import
import_product_file_from_urlImport a product file from a URL
read_product_importRead an uploaded product file
get_product_importGet a product import
start_product_importImport a read file's products into a catalog
link_product_assetLink a library asset to a product or one of its variants
unlink_product_assetUnlink an asset from a product or one of its variants
create_productMake a product in a catalog without a shop system
update_productChange a product made in Ghostpull
start_brand_analysisAnalyze a shop's brand from its web address
get_brand_analysisRead a brand analysis
approve_brand_analysisApprove a brand analysis as the shop's brand
list_brandsList the account's brands
get_brandRead a brand
update_brandEdit a brand
set_default_brandMake a brand the account's default
attach_brand_fontSet a brand's heading or body font file
import_google_brand_fontUse a Google font as a brand's heading or body font file
delete_brandDelete a brand
start_media_uploadStart uploading a file to the media library
complete_media_uploadFinish an upload to the media library
start_orchestrator_runRun an Addon's Workflowspend_credits
get_billing_balanceGet the account's credits
get_billing_catalogList the plans and credit packs an account can buy
get_billing_subscriptionGet the account's plan subscription
start_billing_checkoutStart subscribing to a plan
start_credit_pack_checkoutStart buying a credit pack
list_orchestrator_runsList your runs
get_orchestrator_runGet a run's status and outputs
redo_orchestrator_runMake a finished run again with a notespend_credits
list_running_orchestrator_runsList the runs that are running now
start_orchestrator_batchRun an Addon on a set of itemsspend_credits
get_orchestrator_batchGet a batch's items and their results
cancel_orchestrator_batchCancel a batch
retry_orchestrator_batchRetry a batch's failed itemsspend_credits
redo_orchestrator_batchMake finished items of a batch again with a notespend_credits
set_orchestrator_batch_item_versionChoose which version a redone batch item shows
list_orchestrator_batchesList your batches
get_helpRead the help documents
create_support_caseReport a problem, a wish or an unanswered question
list_support_casesList support cases (admins)
get_support_caseRead a support case (admins)
reply_to_support_caseAnswer a support case (admins)support_admin
set_support_case_statusClose, reopen or export a support case (admins)support_admin
get_model_call_costs_per_addonModel call costs per Addon and period (admins only)support_admin
list_model_call_costs_per_runModel call costs per run in a period (admins only)support_admin
list_support_proposalsList proposals for changes (admins)support_review
create_support_proposalPropose a change from support cases (admins)support_review
set_support_proposal_statusExport, reject or reopen a proposal (admins)support_review
import_chat_fileImport files attached in ChatGPT
show_media_uploadLet the user upload photos
show_media_pickerLet the user pick photos from their Media library
import_chat_product_fileImport a product file attached in ChatGPT
show_choicesLet the user pick from a planning run's choices
show_product_importLet the user import a product file

Next​