docs: add docs on the validate tool

Author: DaleSeo

crates/apollo-mcp-server/src/introspection/tools/execute.rs

@@ -36,7 +36,7 @@ impl Execute {
             mutation_mode,
             tool: Tool::new(
                 EXECUTE_TOOL_NAME,
-                "Execute a GraphQL operation. Use the `introspect` tool to get information about the GraphQL schema. Always use the schema to create operations - do not try arbitrary operations. If available, first use the `validate` tool to validate operations. DO NOT try to execute introspection queries.",
+                "Execute a GraphQL operation. Use the `introspect` tool first to get information about the GraphQL schema. Always use the schema to create operations - do not try arbitrary operations. If available, first use the `validate` tool to validate operations. DO NOT try to execute introspection queries.",
                 schema_from_type!(Input),
             ),
         }

docs/source/command-reference.mdx

@@ -142,6 +142,8 @@ These fields are under the top-level `introspection` key.
 | `introspect.enabled` | `bool`   | `false` | Enable introspection requests                                         |
 | `search`             | `object` |         | Search tool configuration                                             |
 | `search.enabled`     | `bool`   | `false` | Enable search tool                                                    |
+| `validate`           | `object` |         | Validation tool configuration                                         |
+| `validate.enabled`   | `bool`   | `false` | Enable validation tool                                                |
 
 
 #### Logging configuration

docs/source/guides/index.mdx

@@ -161,6 +161,7 @@ You can enable the following introspection tools:
 
 - `introspect` - allows the AI model to introspect the schema of the GraphQL API by providing a specific type name to get information about, and a depth parameter to determine how deep to traverse the subtype hierarchy. The AI model can start the introspection by looking up the top-level `Query` or `Mutation` type.
 - `search` - allows the AI model to search for type information by providing a set of search terms. This can result in fewer tool calls than `introspect`, especially if the desired type is deep in the type hierarchy of the schema. Search results include all the parent type information needed to construct operations involving the matching type.
+- `validate` - validates a GraphQL operation against the schema without executing it. This allows AI models to verify that their operations are syntactically correct and conform to the schema before execution, preventing unintended side effects. Operations should be validated prior to calling the `execute` tool.
 - `execute` - executes an operation on the GraphQL endpoint
 
 The MCP client can use these tools to provide schema information to the model and its context window, and allow the model to execute GraphQL operations based on that schema.
@@ -177,6 +178,8 @@ introspection:
     enabled: true
   introspect:
     enabled: true
+  validate:
+    enabled: true
 ```
 
 ```sh title="Example command using introspection"