| name | shopify-storefront |
| description | Shopify Storefront allows you to create custom shopping experiences using Shopify’s Storefront API, giving full control over design and functionality of the eCommerce front-end. Read and write Shopify Storefront data through One: customers, cart, carts, cartdeliveryaddresses, customeraccesstokens, collections and more, 75 actions with real parameter documentation. Use whenever the user asks to look something up in Shopify Storefront, create or update a record there, or build code against the Shopify Storefront API. |
Shopify Storefront through One
Shopify Storefront allows you to create custom shopping experiences using Shopify’s Storefront API, giving full control over design and functionality of the eCommerce front-end.
One exposes Shopify Storefront through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actions with platform shopify-storefront if it is not listed.
- Call
get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
- Call
execute_one_action with parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm Shopify Storefront is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real Shopify Storefront account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
Customers
| Action | Method | Path | Action id |
|---|
| Activate a Customer (customerActivate Mutation) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gq-SMVEk::Ys4fPLT-Qn2AVDx3Z-Cozg |
| Activate a Customer Using an Activation URL (customerActivateByUrl) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrB4W4V8::49QlIFI1TIGn4RM6z1wiVA |
| Create a Customer (customerCreate Mutation) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrMho3uM::khsnxreKRlieKHDvdqDqPg |
| Get Customer (by Customer Access Token) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsLQS1bs::QuDUndVuRpuFcJSN_tWm4Q |
| Reset a Customer Password by Reset URL (customerResetByUrl) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrU07AT8::aJq3xIRDSPuhapRNVm5dZA |
| Reset a Customer’s Password (customerReset Mutation) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrUFuwgU::EKhnTOs4QGCyATM50sq3gw |
| Send a Customer Password Recovery Email (customerRecover) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrVGiz7A::fuD_lwJWTzm1cp6ChBiuDg |
| Update a Customer (customerUpdate Mutation) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrUUE308::FzoGWU2kRu-RpTlpNXDgxg |
| Update a Customer’s Default Address (customerDefaultAddressUpdate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrNBLeNQ::1KaiP_sQTVi_2_CDqjv-BA |
Cart
| Action | Method | Path | Action id |
|---|
| Clone a Cart (Remove PII) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqRLsP6I::AfBdEcnrTKKVxwBgmKyysg |
| Prepare a Cart for Checkout Completion (cartPrepareForCompletion) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gq0npGZw::f0zaYMxPRImp44wTQkaP0Q |
| Remove Gift Card Codes From a Cart (cartGiftCardCodesRemove) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqlxG-Ss::QXgYOToZTGq73kXwUNEZ6w |
| Remove Personal Data From a Cart (cartRemovePersonalData) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gq0w1keI::cBSdvHvzQUSjI5Qh1pydDg |
| Update a Cart’s Attributes (cartAttributesUpdate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqNx7PzQ::Kfjte9S_QcmIiKStJcoyPA |
| Update a Cart’s Billing Address (cartBillingAddressUpdate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqQr4Gek::doYk6C9MTPyMWetKXhXiJg |
| Update a Cart’s Payment Method (cartPaymentUpdate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqtsAkzA::kD18_Vp-S2qO6k9jk-T0RA |
Carts
| Action | Method | Path | Action id |
|---|
| Create a Cart (cartCreate Mutation) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqOrqy_M::Xv16g5iURJqLYnId1Af40A |
| Retrieve a Cart by ID (Storefront API) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrrWfH2E::PXgOCoDHTUehOk2ZRJGExQ |
| Submit a Cart for Checkout Completion (cartSubmitForCompletion) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gq09UyXs::JlwAZW27QqyO11YfyWG1wA |
| Update a Cart Note (cartNoteUpdate Mutation) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqtvwAr8::JqG21VZ6Q-6pqeJnwzf_GA |
| Update a Cart’s Buyer Identity (cartBuyerIdentityUpdate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqNk6vos::-MRpfx_jQDGF_XshinNu_Q |
CartDeliveryAddresses
| Action | Method | Path | Action id |
|---|
| Add Delivery Addresses to a Cart (cartDeliveryAddressesAdd) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqY7qI3A::XSSGCvYoRAOeEXxaM_uE-Q |
| Remove Delivery Addresses from a Cart (cartDeliveryAddressesRemove) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqYFGrgg::3hSR0HuqQjmdBqBaNKLd_Q |
| Replace a Cart’s Delivery Addresses (cartDeliveryAddressesReplace) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqY_JxPQ::5ySOCzo_Rh2BEgK6uTOl7g |
| Update a Cart’s Delivery Addresses (cartDeliveryAddressesUpdate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqX8HNyo::GW_K-7LnTzOe-txHPEbJpg |
CustomerAccessTokens
| Action | Method | Path | Action id |
|---|
| Create a Customer Access Token (customerAccessTokenCreate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gq065Llw::p1upEdI0SSmCqYbuJ2vvRw |
| Create a Customer Access Token with Multipass | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gq8zqlCc::AVuPuVTdSMOlsSJ6GMFf3A |
| Delete a Customer Access Token | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrF17YfU::kVLW6yUiTBC1Z82Rdff0MA |
| Renew a Customer Access Token (customerAccessTokenRenew) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gq_yB-p4::xysltFGyRMS5ggZv13-MoA |
Collections
| Action | Method | Path | Action id |
|---|
Get a Collection (Storefront GraphQL collection Query) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrrW91e4::tT7-pJnYQjO30wcvny2h4Q |
Get a Collection by Handle (Storefront GraphQL: collectionByHandle) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrvN53XU::Odvck-l5R1aNwiZV_HiSfA |
| List Collections (GraphQL Query) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsKtUPYw::HhIfRXOMTbaeO9lYCSbFZA |
Products
| Action | Method | Path | Action id |
|---|
Find a Product by Handle (Storefront GraphQL productByHandle) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gsre_mzo::BhEhZGehRNOhTBnHvz0O-Q |
Get a Product (Storefront GraphQL product Query) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsjUo5qs::xRcxtTsiR6epYBNs_EKFTQ |
| List Products (Storefront GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsqTJCaw::KRrsgPyBScG6bQEGMnGp_Q |
CartLines
| Action | Method | Path | Action id |
|---|
| Add Lines to a Cart (cartLinesAdd) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqmO-Y40::EuvZ9--LQ7CiOZ27lj1wmw |
| Remove Cart Lines (cartLinesRemove) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqlkR29I::dLYOjZB7RSOQeKOX2FAjqQ |
| Update Cart Lines (cartLinesUpdate Mutation) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqtTaWsA::_0w6-uxIRYusMKunsxtUug |
Pages
| Action | Method | Path | Action id |
|---|
| Find a Page by Handle (Storefront GraphQL: pageByHandle) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsgEo3bg::fijLHYj7TgmdLFHNb41WPQ |
| Get a Page (Storefront API) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsUYtXdc::Tc-o9GhnT_qyNQmiiYKZ_g |
List Shop Pages (GraphQL pages Query) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsgaDfTc::YxiWmWT6RQalisjn1roZKg |
Blogs
| Action | Method | Path | Action id |
|---|
| Find a Blog by Handle (Storefront) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrkZk2P8::vDl0J57SRwCbrI1lQrheIw |
| Get a Blog (Storefront GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Grh3aTIs::vxDl8wioR_u2tWGmgdF62g |
| List Blogs (GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsDgBniI::NSOBL2MWQG6HiZhSIty0JQ |
CustomerAddresses
| Action | Method | Path | Action id |
|---|
| Create a Customer Address (customerAddressCreate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrMWidsk::2sxsfCylT2CG2ntnvUsyug |
| Delete a Customer Address (customerAddressDelete Mutation) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrNT8xEI::Z8FLcbPjQCObI-TcyRN9sQ |
| Update a Customer Address (customerAddressUpdate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrMWsiBs::TrnVj2BpR8WniKhPXs7nQQ |
CartMetafields
| Action | Method | Path | Action id |
|---|
| Delete a Cart Metafield (cartMetafieldDelete) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqtqZB2c::6AI-096dReWt24Q3WHARlw |
| Set Cart Metafields (cartMetafieldsSet Mutation) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gqstz6uI::CoKdeDRwTPC74NqDEcEt1Q |
CartGiftCardCodes
| Action | Method | Path | Action id |
|---|
| Add Gift Card Codes to a Cart (cartGiftCardCodesAdd) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GqmLgsKY::SaYpMt0mSJO_uTWHdU4-Yw |
| Update a Cart’s Gift Card Codes (cartGiftCardCodesUpdate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gqlj2dyc::tZ3EFS1PQuWSDzmP33UbmQ |
ShopPayPaymentRequestSessions
| Action | Method | Path | Action id |
|---|
| Create a Shop Pay Payment Request Session (shopPayPaymentRequestSessionCreate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrWK-rNQ::YZ6QD0DHSVSUjjqMyAHxwQ |
| Submit a Shop Pay Payment Request Session (Mutation) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrdPJfrE::hVB6i9TNTpCeS01WRdjHxw |
Articles
| Action | Method | Path | Action id |
|---|
| Get an Article by ID (Storefront GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Grdd0rvw::F8hmKZ_XQ6y5BGSYf86ZRQ |
| List Articles (GraphQL Query) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GrdT-Y2E::BTkBeTdBQyCSn-QCgB4RBg |
Metaobjects
| Action | Method | Path | Action id |
|---|
| Get a Metaobject (GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsT1Q6SQ::kCc28W6WSO2h79_jJqrfLQ |
| List Metaobjects (GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsUy9pEQ::4OZZCw4fSBuYnJbQJcv6FA |
Nodes
| Action | Method | Path | Action id |
|---|
| Get a Node by ID (GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsZD5mfI::8kqeKZMaQR-v1W-zUfF8hw |
| Query Nodes by IDs | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsT-DnFM::Keo-LtnSQNWhycCdAuhNuQ |
NavigationMenus
| Action | Method | Path | Action id |
|---|
| Retrieve a Navigation Menu by Handle (GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsNMxg-Y::trZWYQ_rTuKX5ewhEwoqFA |
PaymentSettings
| Action | Method | Path | Action id |
|---|
| Query Payment Settings | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsgHqxzk::-bKuYzj5TI6adILxbS75SA |
Sitemap
| Action | Method | Path | Action id |
|---|
| Query a Sitemap by Resource Type (GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsyD8KYw::fU6wQXLJSEm5b-cuKntw0w |
Graphql
| Action | Method | Path | Action id |
|---|
Search Store Resources (GraphQL search Query) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsyWiYKw::VJ7Ku2anS7iC8VJX-MNm7Q |
CartSelectedDeliveryOptions
| Action | Method | Path | Action id |
|---|
| Update a Cart’s Selected Delivery Options (cartSelectedDeliveryOptionsUpdate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gq1XRuk0::0lA-63L0SgGFPZUDTnw4fA |
Locations
| Action | Method | Path | Action id |
|---|
List Store Locations (GraphQL locations Query) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsKwruPs::JxWIV0RlTyOuzTZs4pTPww |
Localization
| Action | Method | Path | Action id |
|---|
| Query Shop Localization | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsLRTVgI::Rf_4YmvqShashjATiRvcWQ |
ProductRecommendations
| Action | Method | Path | Action id |
|---|
| Get Product Recommendations (GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gsp1cJwM::I15TfUaGSjiscliv9I0BWQ |
ProductTags
| Action | Method | Path | Action id |
|---|
| List Product Tags (GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsqQR12g::HJgCX3zoQJq_kiLRblCLPg |
PredictiveSearchResults
| Action | Method | Path | Action id |
|---|
| List Predictive Search Results (GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsgYNBow::TeVxctqhSj2AdW9yokqB7Q |
CartDiscountCodes
| Action | Method | Path | Action id |
|---|
| Update a Cart’s Discount Codes (cartDiscountCodesUpdate) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gqet17GM::T-Loji9TSNmtUhVP0qPJGA |
ProductTypes
| Action | Method | Path | Action id |
|---|
| List Product Types (GraphQL) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gsp6aTik::EQUN_zapTP-z9Vk9Kt-row |
UrlRedirects
| Action | Method | Path | Action id |
|---|
List a Shop’s URL Redirects (GraphQL: urlRedirects query) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7GsyTClyU::i5IjBT_8Remz7uUqdLw4bA |
CartCompletionAttempt
| Action | Method | Path | Action id |
|---|
| Get a Cart Completion Attempt Result | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Grq_Iq_I::3CthnvILSUaNdI8ZeFHB6A |
StorefrontApiVersions
| Action | Method | Path | Action id |
|---|
| List Public Storefront API Versions | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gsyt-TNw::ZqkGHLwASN-Z-GMa4nuuCQ |
Shop
| Action | Method | Path | Action id |
|---|
| Query the Shop (Storefront) | POST | /api/2026-01/graphql.json | conn_mod_def::GJ7Gsy6WLVg::G2Zv1K5dRcqyhL_uy0ZYlg |
When a call fails
The error comes from Shopify Storefront, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/shopify-storefront
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
