get_mutation_details

Instructions

Retrieves argument requirements, return type information, descriptions, and
example usage for the specified mutations.

Args:
    mutation_names: Comma-separated list of mutation names to get details for

Returns:
    A YAML-formatted string containing detailed information about the requested mutations

Implementation Reference

• src/bloomy_mcp/operations.py:145-157 (handler)

  The handler function that implements the core logic of the 'get_mutation_details' tool by delegating to the shared get_operation_details helper with mutation type.

  def get_mutation_details(mutation_names: str) -> str:
      """Get detailed information about specific GraphQL mutations.
  
      Retrieves argument requirements, return type information, descriptions, and
      example usage for the specified mutations.
  
      Args:
          mutation_names: Comma-separated list of mutation names to get details for
  
      Returns:
          A YAML-formatted string containing detailed information about the requested mutations
      """
      return get_operation_details(mutation_names, "mutation")

• src/bloomy_mcp/operations.py:15-127 (helper)

  Core helper function that performs the GraphQL introspection query to fetch operation details, formats arguments and types, generates examples, and returns YAML output. Used by both get_query_details and get_mutation_details.

  def get_operation_details(operation_names: str, operation_type: str) -> str:
      """Get detailed information about specific GraphQL operations.
  
      Retrieves and formats detailed information about GraphQL queries or mutations,
      including arguments, return types, and example usage.
  
      Args:
          operation_names: Comma-separated list of operation names to get details for
          operation_type: Either "query" or "mutation"
  
      Returns:
          A YAML-formatted string containing detailed information about the requested operations
  
      Raises:
          Exception: If there's an error retrieving the operation details
      """
      type_name = "QueryType" if operation_type == "query" else "MutationType"
  
      details_query = gql(
          f"""
      {{
        __type(name: "{type_name}") {{
          fields(includeDeprecated: false) {{
            name
            description
            args {{
              name
              description
              type {{
                kind
                name
                ofType {{
                  kind
                  name
                  ofType {{
                    kind
                    name
                    ofType {{
                      kind
                      name
                    }}
                  }}
                }}
              }}
              defaultValue
            }}
            type {{
              kind
              name
              ofType {{
                kind
                name
              }}
            }}
          }}
        }}
      }}
      """
      )
  
      try:
          result = default_client.execute(details_query)
  
          # Parse the list of operation names
          operation_name_list = [name.strip() for name in operation_names.split(",")]
  
          # Collect all requested operations
          all_details = {}
  
          for operation_name in operation_name_list:
              # Find the specific operation
              operation_info = None
              for field in result["__type"]["fields"]:
                  if field["name"] == operation_name:
                      operation_info = field
                      break
  
              if not operation_info:
                  all_details[operation_name] = f"{operation_type.capitalize()} '{operation_name}' not found"
                  continue
  
              # Format arguments
              args = []
              for arg in operation_info["args"]:
                  type_info = format_type_info(arg["type"])
                  args.append(
                      {
                          "name": arg["name"],
                          "description": arg["description"] or "No description",
                          "type": type_info,
                          "required": type_info.endswith("!"),
                          "defaultValue": arg["defaultValue"],
                      }
                  )
  
              # Format return type
              return_type = format_type_info(operation_info["type"])
  
              # Create result structure
              details = {
                  "name": operation_name,
                  "description": operation_info["description"] or "No description",
                  "arguments": args,
                  "returnType": return_type,
                  "example": generate_operation_example(operation_name, args, operation_type),
              }
  
              all_details[operation_name] = details
  
          return yaml.dump(all_details, sort_keys=False)
  
      except Exception as e:
          return f"Error getting {operation_type} details: {str(e)}"

• src/bloomy_mcp/server.py:36-40 (registration)

  MCP tool registration block where get_mutation_details is registered as a tool using the FastMCP mcp.tool() decorator.

  # Register tools
  mcp.tool()(get_query_details)
  mcp.tool()(get_mutation_details)
  mcp.tool()(execute_query)
  mcp.tool()(get_authenticated_user_id)