-
#70
90b4318Thanks @hajoeichler! - Upgradezodfrom v3 to v4 (^4.0.0).Consumers that define custom tools or extend the SDK with their own zod schemas will need to migrate to zod v4 as well. The
ZodObjectgeneric now takes two type parameters instead of four/five, andZodError.issuesreplaces the deprecated.errors/.formErrorsaccessors. See the zod v4 migration guide for details.The unused
zod-to-json-schemadependency has been removed; if you used it transitively, switch to the nativez.toJSONSchema()in zod v4.
- Updated dependencies [
90b4318]:- @commercetools/agent-essentials@4.0.0
-
#47
2bae83eThanks @ajimae! - [Fix][DEVX-670] Fix Issues with Tools Configuration -
Updated dependencies [
2bae83e]:- @commercetools/agent-essentials@3.5.1
- Updated dependencies [
b88f1bd]:- @commercetools/agent-essentials@3.5.0
-
#40
e854cc4Thanks @ajimae! - [Feat][DEVX-654] Add Missing Critical Tools -
#28
6eb40d5Thanks @Trackerchum! - Resource response data transformation to tabular-like LLM formatting, with command-line flag to revert back to JSON.
-
#31
e21e319Thanks @ajimae! - [Feat][MCP-8] Improve Tracing in MCP Server -
#34
7736450Thanks @martinw-ct! - Added fieldType to search_productsNecessary when sorting by attributes to avoid errors like:
SDKError: Failed to search products Field [variants.attributes.weight]: Type is missing
- Updated dependencies [
899d731]:- @commercetools/agent-essentials@3.2.0
-
#22
733f7fcThanks @islam3zzat! - Add dynamic tool loading feature. In this feature, if the number available tools exceededDYNAMIC_TOOL_LOADING_THRESHOLDwe'll only expose 5 tools:- list_tools
- inject_tool
- execute_tool
- bulk_create
- bulk_update
This will drastically reduce the amount of context we take from the client's LLM for tools' description and schema.
-
#20
80996f0Thanks @martinw-ct! - The MCP now return more detailed error messageBefore this change: SDKError: Failed to update cart
After this change: SDKError: Failed to update cart: Failed to update cart by ID: The variant '2' with SKU '' of product '' does not contain a price for currency 'EUR' country 'DE', all customer groups and all channels.
-
#17
3c5e8a9Thanks @ajimae! - [Feat][MCP-6] Scope Based Tools Filtering
-
#18
9a205aaThanks @islam3zzat! - Suppress dotenv logs to avoid pushing messages to the stdio. -
Updated dependencies [
80996f0,f56607f,3c5e8a9]:- @commercetools/agent-essentials@3.0.0
-
#15
8afdf31Thanks @islam3zzat! - Add support for authenticating via existingaccess_token.Example:
const commercetoolsAgentEssentials = new CommercetoolsAgentEssentials({ authConfig: { type: 'auth_token', accessToken: process.env.ACCESS_TOKEN!, projectKey: process.env.PROJECT_KEY!, authUrl: process.env.AUTH_URL!, apiUrl: process.env.API_URL!, }, configuration: { actions: { products: { read: true, create: true, update: true, }, project: { read: true, }, }, }, });
BREAKING CHANGE: The constructor signature of
CommercetoolsAgentEssentialshas changed to support more authentication types. See example below to learn what changed.Example:
- const commercetoolsAgentEssentials = new CommercetoolsAgentEssentials({ - clientId: process.env.CLIENT_ID!, - clientSecret: process.env.CLIENT_SECRET!, - projectKey: process.env.PROJECT_KEY!, - authUrl: process.env.AUTH_URL!, - apiUrl: process.env.API_URL!, - configuration: { - actions: { - products: { - read: true, - create: true, - update: true, - }, - project: { - read: true, - }, - }, - }, - }); + const commercetoolsAgentEssentials = new CommercetoolsAgentEssentials({ + authConfig: { + type: 'client_credentials', + clientId: process.env.CLIENT_ID!, + clientSecret: process.env.CLIENT_SECRET!, + projectKey: process.env.PROJECT_KEY!, + authUrl: process.env.AUTH_URL!, + apiUrl: process.env.API_URL!, + }, + configuration: { + actions: { + products: { + read: true, + create: true, + update: true, + }, + project: { + read: true, + }, + }, + }, + });
- #3
5bd6b14Thanks @tdeekens! - This is the initial release of the commerce MCP essentials and Agent essentials. This is an Early access release and we’d love to hear your feedback!
- Updated dependencies [
5bd6b14]:- @commercetools/agent-essentials@1.0.0