big-commerce

BigCommerce through One

BigCommerce is an open SaaS eCommerce platform that enables businesses to build, scale, and manage online stores. It offers robust features for multi-channel selling, analytics, and performance optimization.

One exposes BigCommerce 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

1. Find the action in the table below, or call search_one_platform_actions with platform big-commerce if it is not listed.
2. 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.
3. 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 BigCommerce 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 BigCommerce 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
Get a Count of Customers	GET	/v2/customers/count	conn_mod_def::GJ0JAZha-sY::EmUKsGniT_qSZJXEoFaxJg
Get a Customer	GET	/v2/customers/{{customerId}}	conn_mod_def::GJ0JAiEvZHM::5A9RmU5yQYSZc4D3pXZ3KA
List Customers	GET	/v2/customers	conn_mod_def::GJ0JAueBlwQ::FUCRf457QY-Iu18kq17Y9g
List Customers	GET	/v3/customers	conn_mod_def::GJ0JA9aaSGI::21f75pEhTXq1zKdihJU42g
Create a New Customer	POST	/v2/customers	conn_mod_def::GJ0I_tpZ8eU::TALnRaYtQxKXi6l9BYXH5A
Create Customers (Bulk)	POST	/v3/customers	conn_mod_def::GJ0I_3fPhE8::wfqpyg9iQ4unavuwhZxEtw
Delete a Customer	DELETE	/v2/customers/{{customerId}}	conn_mod_def::GJ0I__z_E3o::IrZYUBRfR36YhvXmOHstjw
Delete Customers	DELETE	/v2/customers	conn_mod_def::GJ0JAJI46OY::HABZeWRZQNiiChDwxgkfWg
Delete Customers (Bulk)	DELETE	/v3/customers	conn_mod_def::GJ0JASrZKbc::6gfzNc_uQ1yjH3e4bVeKkg
Update a Customer	PUT	/v2/customers/{{customerId}}	conn_mod_def::GJ0JBGiq2pM::WauAxjuLRZ-rGEZQZwcWcw
Update Customers (Bulk)	PUT	/v3/customers	conn_mod_def::GJ0JBP82OQ4::VzWbo63vQkqm2P7J3q2Cxw
Validate a Customer’s Credentials	POST	/v3/customers/validate-credentials	conn_mod_def::GJ0J4sfSiE4::2z1PGGzoR-iL2TGX0g1BZQ