Fluent Commerce Logo
Docs

Generate GraphQL queries using the Builder MCP Server

How-to Guide

Author:

John Vurdelja

Changed on:

4 Feb 2026

Key Points

  • Use natural language to create the GraphQL query you need
  • Quick creation of queries - without having to research the schema and manually build out the query
  • Reduce hallucinations

Steps

Step arrow right iconDescribe the query

Use the `/fluent-mcp:prime` command in Claude Code, and describe what you need the query to do. Something like: `Return all the fulfilments and their items that are currently awaiting wave at a given location.`

Step arrow right iconProcessing and Output

Here is an example of what Claude Code would output in this example:No alt providedThere are three main parts of this process:
  • Using the MCP resources and tools to get the required supporting GraphQL information used to help generate the query.
  • Creation of the query, along with validation against the schema.
  • Output - provides the query, necessary variables, some notes about what the query does, and any other instructions like replacing the variable placeholder text.

Additional Examples


Step arrow right iconHere are a few more examples of this GraphQL query generation

Input: `Fetch total reservations for a product broken down by location`Output:No alt providedInput: `Get me the GTINs for all items on a given order`

NOTE: This is a more complex version that incorporates a fragment in the query to get to the required Variant Product data.
Output:No alt provided