Shopigent Shopigent

Tools Reference

Shopigent exposes 92 curated tools across 10 categories. Each category can be toggled on/off per store, and write tools always pass through the confirmation gate.

Tools are curated operations, not raw API passthrough — inputs are validated, outputs are trimmed to what agents actually need, and destructive calls require human approval.

Plans at a glance

Plan Daily calls Access
Free 25/day Read-only (queries)
Growth 500/day All writes except premium tools
Pro Unlimited Everything, including translations + theme editing

Premium (Pro-only) tools: set_translations, get_translations, delete_translations, update_theme_content, update_theme_file, update_theme_translations, duplicate_theme, publish_theme.

Products (28)

Tool Type Plan What it does
list_products Read Free Paginated list of products, optionally filtered by a search query.
search_products Read Free Full-text search across product titles, descriptions, and tags with relevance scoring.
get_product_by_id Read Free Fetch a single product by its Shopify GID.
create_product Write Growth Creates a new product with optional description, status, vendor, type, price, SKU, barcode, weight, and tags.
update_product Write Growth Updates a product's fields including title, description, status, vendor, type, tags, SEO, handle, and template (templateSuffix / clearTemplateSuffix).
delete_product Write Growth Permanently deletes a product. Irreversible.
create_product_variant Write Growth Adds a variant (SKU, price, weight, barcode) to an existing product.
update_product_variant Write Growth Sets SKU, price, weight, and barcode on an existing product variant.
update_product_variant_price Write Growth Sets the price of a single product variant by its GID.
bulk_update_prices Write Growth Updates prices for multiple variants at once.
update_product_images Write Growth Manages product images (add, update alt text, delete) via the Shopify Media API.
upload_product_media Write Growth Uploads media to a product using Shopify's staged-upload flow.
get_product_media Read Free Lists media attached to a product.
get_product_publications Read Free Lists where a product is published (channels, online store, etc.).
get_product_metafields Read Free Reads metafields attached to a product.
set_product_metafields Write Growth Writes or updates one or more product metafields.
get_store_info Read Free Returns store-level information: name, email, currency, timezone, and plan.
list_collections Read Free Lists all collections (manual + automated) with id, title, handle, and sort order.
get_collection_by_id Read Free Fetches a single collection by its GID, including description, image, product count.
create_collection Write Growth Creates a new manual or automated collection.
update_collection Write Growth Updates a collection's title, description, handle, sort order, and/or SEO.
delete_collection Write Growth Deletes a collection by its GID.
add_products_to_collection Write Growth Adds one or more products to a collection.
remove_products_from_collection Write Growth Removes one or more products from a collection.
update_collection_image Write Growth Adds, updates, or deletes a collection's image.
get_translations Read Pro Reads all translatable content for a resource (product, collection, page, etc.) in a locale.
set_translations Write Pro Writes or updates translation values for a resource in a locale.
delete_translations Write Pro Removes translation overrides for given keys in a locale.

Content (16)

Tool Type Plan What it does
list_pages Read Free Lists all pages with id, title, handle, and status.
get_page_by_id Read Free Fetches a single page by its GID, including body and SEO metadata.
create_page Write Growth Creates a new online store page.
update_page Write Growth Updates a page's title, body, and/or handle.
delete_page Write Growth Deletes a page by its GID.
list_blogs Read Free Lists all blogs with id, title, handle, and comment policy.
get_blog_by_id Read Free Fetches a single blog by its GID, including its articles and metadata.
create_blog Write Growth Creates a new blog.
update_blog Write Growth Updates a blog's title and/or handle.
delete_blog Write Growth Deletes a blog by its GID.
list_articles Read Free Lists all blog articles for a blog, with optional filters.
get_article_by_id Read Free Fetches a single blog article by its GID, including body, summary, tags, author.
create_article Write Growth Creates a new blog post (article) under a blog.
update_article Write Growth Updates a blog post's title, body, summary, handle, tags, author.
delete_article Write Growth Deletes a blog post by its GID.
update_article_image Write Growth Adds, updates, or deletes a blog article's featured image.

Metaobjects / Custom Data (15)

Access to Custom Data (metaobjects & metafield definitions) requires a dedicated scope category in Scopes & Permissions.

Tool Type Plan What it does
list_metaobjects Read Free Lists metaobjects of a given type.
list_metaobject_definitions Read Free Lists metaobject definitions.
get_metaobject Read Free Fetches a single metaobject by its GID.
create_metaobject Write Growth Creates a new metaobject.
update_metaobject Write Growth Updates an existing metaobject.
delete_metaobject Write Growth Deletes a metaobject. Destructive.
get_metaobject_definition Read Free Fetches a single metaobject definition.
create_metaobject_definition Write Growth Creates a metaobject definition.
update_metaobject_definition Write Growth Updates a metaobject definition.
delete_metaobject_definition Write Growth Deletes a metaobject definition. Destructive.
list_product_metafield_definitions Read Free Lists metafield definitions scoped to products.
get_metafield_definition Read Free Fetches a single metafield definition.
create_metafield_definition Write Growth Creates a metafield definition.
update_metafield_definition Write Growth Updates a metafield definition.
delete_metafield_definition Write Growth Deletes a metafield definition. Destructive.

Themes (9)

Tool Type Plan What it does
list_themes Read Free Lists all online store themes (main, unpublished, etc.).
get_theme_file Read Free Reads a single theme file (e.g. config/settings_data.json, templates/index.liquid).
upload_theme_asset Write Pro Uploads any file to a theme (images as BASE64, text as TEXT). Supports PNG, JPG, SVG, Liquid, JSON, CSS, JS.
duplicate_theme Write Pro Creates a copy of an existing theme for safe editing.
update_theme_content Write Pro Edits the Customizer content of a theme via config/settings_data.json.
update_theme_file Write Pro Writes/overwrites ANY theme file (Liquid template, section, snippet, JSON).
publish_theme Write Pro Makes a theme the live (published) theme.
get_theme_translations Read Free Reads all theme content translations for a given locale.
update_theme_translations Write Pro Writes/updates theme content translations for one or more keys.

Orders (6)

Tool Type Plan What it does
list_orders Read Free Paginated list of orders, filterable by status/date/tags.
search_orders Read Free Full-text search across orders by number, customer name, or email.
get_order Read Free Fetches a single order by its GID (line items, addresses, tags, status).
create_order Write Growth Creates a draft order with line items and customer info.
update_order Write Growth Updates editable order fields: tags, note, and/or email.
refund_order Write Growth Issues a refund on an order. Irreversible financial action.

Customers (5)

Tool Type Plan What it does
list_customers Read Free Lists store customers with optional filters.
search_customers Read Free Full-text search across customers by name, email, or phone.
get_customer Read Free Fetches a single customer by GID (name, email, phone, tags, note).
create_customer Write Growth Creates a new customer.
update_customer Write Growth Updates a customer's tags or note.

Discounts (4)

Tool Type Plan What it does
list_discounts Read Free Lists store discounts (discount nodes).
get_discount Read Free Fetches a single discount by its GID node id.
create_discount Write Growth Creates a new discount code or automatic discount.
delete_discount Write Growth Deletes a discount by its GID.

Fulfillments (4)

Tool Type Plan What it does
list_fulfillment_orders Read Free Lists store fulfillment orders.
get_fulfillment_order Read Free Fetches a single fulfillment order by its GID.
close_fulfillment_order Write Growth Closes a fulfillment order (marks it fulfilled/complete).
open_fulfillment_order Write Growth Re-opens a closed fulfillment order.

Inventory (1)

Tool Type Plan What it does
update_inventory_quantity Write Growth Sets the available inventory quantity for an item at a location.

GitHub Theme (4)

The GitHub Theme category connects your store to a GitHub repo that serves as the source of truth for your theme. Theme changes are made as pull requests to that repo and deployed via GitHub Actions — a Git-first workflow that never auto-publishes to your live store. Access is enabled per store from the GitHub Theme page in the Shopigent dashboard (app-internal scope category, not an OAuth scope).

Tool Type Plan What it does
github_theme_connection Read Free Returns whether the store has a GitHub theme repo connected (owner/repo/defaultBranch). Does NOT expose tokens. Read-only.
github_list_theme_branches Read Free Lists branches on the connected store's theme GitHub repo. Requires a GitHub theme connection. Read-only.
github_theme_file Read Free Reads a single file from the theme GitHub repo at a ref (default: default branch). Returns path, branch, sha, and content. Read-only.
github_create_theme_pr Write Growth Commits one or more theme file changes to a new branch and opens a PR on the theme repo. Deploy is handled by GitHub Actions (staging, no auto-publish). Confirmation required; dry-run available.

Cross-cutting features