Skip to main content
GHL MCP Guide
SST

Store Settings

Commerce & Products · Intermediate · Updated March 2026

Create and retrieve store configuration settings including currency, checkout options, tax settings, and general e-commerce preferences.

Store Settings controls the foundational configuration for a GHL storefront. Currency, tax rules, checkout behavior, and general e-commerce preferences — everything that determines how the store operates before a single product is added.

What This MCP Tool Does

This tool lets you create and retrieve store configuration settings for a sub-account. When provisioning a new client storefront, these settings are the first thing you configure. They affect every product, every checkout, every invoice downstream.

Endpoint Reference

Create a store setting: POST /stores/settings Initialize store configuration with currency, tax, and checkout parameters.

Get a store setting: GET /stores/settings/{settingId} Retrieve the current store configuration.

Authentication

Requires a Private Integration Token (PIT) with the stores scope enabled.

Key Parameters

Configuration options include:

  • currency — default currency for the store (ISO code)
  • Tax configuration (rates, tax-inclusive or tax-exclusive pricing)
  • Checkout behavior (guest checkout, account required, terms acceptance)
  • General store metadata

Important Notes

Store settings should be configured before creating products and prices. The currency setting in particular affects how prices are displayed and processed. Changing currency after products are created can cause inconsistencies.

Tax configuration varies significantly by jurisdiction. For US-based clients, sales tax rules depend on nexus states and product types. Consider using automated tax calculation services for complex tax scenarios.

For agency sub-account provisioning, store settings should be part of your setup automation alongside Location CRUD and product catalog creation. A consistent baseline configuration across client storefronts reduces support issues.

Common Questions

Can I change the store currency after setup? Technically yes, but it affects all existing products and prices. If a currency change is needed, it is safer to recreate products with correct pricing in the new currency.

How do I handle sales tax for different states? Tax configuration at the store level sets defaults. For state-by-state compliance, you may need additional tax calculation logic or a third-party tax service integrated into the checkout flow.

Do store settings apply to invoices too? Store settings primarily affect the storefront and checkout. Invoices have their own configuration through Invoice Templates, though they share the same currency and product catalog.

Back to GHL MCP Guide