Shopify MCP Server

Implementation Reference

• src/tools/getCollections.ts:45-96 (handler)

  The execute method containing the core logic for the get-collections tool: parses input, constructs GraphQL query variables, fetches collections from Shopify API, maps response, and handles errors.

    execute: async (input: GetCollectionsInput) => {
      try {
        const { searchTitle, limit } = input;
  
        const query = gql`${GET_COLLECTIONS_QUERY}`;
  
        const variables = {
          first: limit,
          query: searchTitle ? `title:*${searchTitle}*` : undefined
        };
  
        const data = await shopifyClient.request(query, variables) as {
          collections: {
            nodes: Array<{
              id: string;
              handle: string;
              title: string;
              updatedAt: string;
              descriptionHtml: string;
              sortOrder: string;
              templateSuffix: string;
            }>;
          };
        };
  
        const collections = data.collections.nodes.map(node => ({
          id: node.id,
          title: node.title,
          handle: node.handle,
          description: node.descriptionHtml,
          descriptionHtml: node.descriptionHtml,
          updatedAt: node.updatedAt,
          productsCount: 0, // Assuming productsCount is not available in the new query
          seo: {
            title: node.title,
            description: node.descriptionHtml
          },
          image: null, // Assuming image is not available in the new query
          products: []
        }));
  
        return { collections };
      } catch (error) {
        console.error("Error fetching collections:", error);
        throw new Error(
          `Failed to fetch collections: ${
            error instanceof Error ? error.message : String(error)
          }`
        );
      }
    }
  };

• src/tools/getCollections.ts:6-9 (schema)

  Zod schema defining the input parameters for the get-collections tool.

  const GetCollectionsInputSchema = z.object({
    searchTitle: z.string().optional().describe("Optional search term to filter collections by title"),
    limit: z.number().default(10).describe("Maximum number of collections to return (default: 10)")
  });

• src/index.ts:121-133 (registration)

  MCP server registration of the 'get-collections' tool, providing input schema and delegating execution to the imported getCollections.execute method.

  server.tool(
    "get-collections",
    {
      searchTitle: z.string().optional(),
      limit: z.number().default(10)
    },
    async (args) => {
      const result = await getCollections.execute(args);
      return {
        content: [{ type: "text", text: JSON.stringify(result) }]
      };
    }
  );

• src/tools/getCollections.ts:16-30 (helper)

  GraphQL query string used by the handler to retrieve collection data from Shopify.

  const GET_COLLECTIONS_QUERY = `
    query GetCollections($first: Int!, $query: String) {
      collections(first: $first, query: $query) {
        nodes {
          id
          handle
          title
          updatedAt
          descriptionHtml
          sortOrder
          templateSuffix
        }
      }
    }
  `;

• src/index.ts:72-72 (registration)

  Initialization of the getCollections tool with the Shopify GraphQL client instance.

  getCollections.initialize(shopifyClient);