Skip to content

Latest commit

 

History

History
210 lines (146 loc) · 10.4 KB

File metadata and controls

210 lines (146 loc) · 10.4 KB

@commercetools/mcp-essentials

3.0.0

Major Changes

  • #70 90b4318 Thanks @hajoeichler! - Upgrade zod from 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 ZodObject generic now takes two type parameters instead of four/five, and ZodError.issues replaces the deprecated .errors / .formErrors accessors. See the zod v4 migration guide for details.

    The unused zod-to-json-schema dependency has been removed; if you used it transitively, switch to the native z.toJSONSchema() in zod v4.

Patch Changes

  • Updated dependencies [90b4318]:
    • @commercetools/agent-essentials@4.0.0

2.4.2

Patch Changes

  • #47 2bae83e Thanks @ajimae! - [Fix][DEVX-670] Fix Issues with Tools Configuration

  • Updated dependencies [2bae83e]:

    • @commercetools/agent-essentials@3.5.1

2.4.1

Patch Changes

  • Updated dependencies [b88f1bd]:
    • @commercetools/agent-essentials@3.5.0

2.4.0

Minor Changes

  • #40 e854cc4 Thanks @ajimae! - [Feat][DEVX-654] Add Missing Critical Tools

  • #28 6eb40d5 Thanks @Trackerchum! - Resource response data transformation to tabular-like LLM formatting, with command-line flag to revert back to JSON.

  • #41 1e66969 Thanks @ShipilA! - Adding reviews to MCP tools

Patch Changes

2.3.0

Minor Changes

  • #31 e21e319 Thanks @ajimae! - [Feat][MCP-8] Improve Tracing in MCP Server

  • #34 7736450 Thanks @martinw-ct! - Added fieldType to search_products

    Necessary when sorting by attributes to avoid errors like: SDKError: Failed to search products Field [variants.attributes.weight]: Type is missing

Patch Changes

2.2.1

Patch Changes

  • Updated dependencies [899d731]:
    • @commercetools/agent-essentials@3.2.0

2.2.0

Minor Changes

  • #22 733f7fc Thanks @islam3zzat! - Add dynamic tool loading feature. In this feature, if the number available tools exceeded DYNAMIC_TOOL_LOADING_THRESHOLD we'll only expose 5 tools:

    1. list_tools
    2. inject_tool
    3. execute_tool
    4. bulk_create
    5. bulk_update

    This will drastically reduce the amount of context we take from the client's LLM for tools' description and schema.

Patch Changes

  • Updated dependencies [b16df24, 733f7fc]:
    • @commercetools/agent-essentials@3.1.0

2.1.0

Minor Changes

  • #20 80996f0 Thanks @martinw-ct! - The MCP now return more detailed error message

    Before 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 3c5e8a9 Thanks @ajimae! - [Feat][MCP-6] Scope Based Tools Filtering

Patch Changes

2.0.0

Major Changes

  • #15 8afdf31 Thanks @islam3zzat! - Add support for authenticating via existing access_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 CommercetoolsAgentEssentials has 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,
    +       },
    +     },
    +   },
    + });

Minor Changes

  • #9 c78c032 Thanks @ajimae! - Add Streamable HTTP capabilities to Essentials MCP server

Patch Changes

1.0.0

Major Changes

  • #3 5bd6b14 Thanks @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!

Patch Changes

  • Updated dependencies [5bd6b14]:
    • @commercetools/agent-essentials@1.0.0