.. _ref_user_guide:

==========
User guide
==========

Learn how to use PyMechanical-MCP effectively.

.. grid:: 2 2 3 3
    :gutter: 1 2 3 3
    :padding: 1 2 3 3

    .. grid-item-card:: :fa:`info-circle` Overview
        :link: overview
        :link-type: doc

        What is PyMechanical-MCP, how does it work, and why use it?

    .. grid-item-card:: :fa:`tools` Tools and capabilities
        :link: tools_and_capabilities
        :link-type: doc

        Reference for every tool PyMechanical-MCP exposes.

    .. grid-item-card:: :fa:`sliders` Configuration
        :link: configuration
        :link-type: doc

        Startup flags, environment variables, transport modes, and connection options.

    .. grid-item-card:: :fa:`docker` Docker deployment
        :link: docker
        :link-type: doc

        Guide to deploying PyMechanical-MCP in a containerized environment.

    .. grid-item-card:: :fa:`check-circle` Best practices
        :link: best_practices
        :link-type: doc

        Workflow recommendations for sessions, scripting, and result handling.


.. toctree::
   :hidden:

   overview
   tools_and_capabilities
   configuration
   best_practices
   docker