# Pymapdl Mcp

> PyMAPDL MCP Server

- **Type:** MCP server
- **Install:** `agentstack add mcp-ansys-pymapdl-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ansys](https://agentstack.voostack.com/s/ansys)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [ansys](https://github.com/ansys)
- **Source:** https://github.com/ansys/pymapdl-mcp
- **Website:** http://mapdl-mcp.docs.pyansys.com/

## Install

```sh
agentstack add mcp-ansys-pymapdl-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# PyMAPDL MCP Server

[](https://docs.pyansys.com/)
[](https://www.python.org/)
[](https://opensource.org/licenses/Apache-2.0)

PyMAPDL MCP Server provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)
server that enables AI assistants to interact with Ansys MAPDL (Mechanical APDL) through
[PyMAPDL](https://mapdl.docs.pyansys.com/). This server enables natural language interaction with MAPDL for finite element analysis tasks.

## Overview

Key features:

- **Dynamic connection management**: Launch new MAPDL instances, connect to existing ones, or disconnect on demand
- **Execute MAPDL commands**: Run single commands or batch multiple commands for efficiency
- **Custom Python execution**: Run arbitrary Python and PyMAPDL code in a persistent session
- **Advanced visualization**: Create custom ``matplotlib`` and ``pyvista`` plots, or capture MAPDL native plots
- **Workflow guidance**: Access comprehensive context and best practices for all phases of MAPDL simulations
- **Flexible deployment**: Works with MAPDL running locally, remotely, or in Docker containers

https://github.com/user-attachments/assets/99b68fbd-2308-46a0-aa44-9684ae7400b7

Video 1: PyMAPDL MCP Demo

  Your browser does not support the video tag.

## Installation

### For users

Install the latest release with:

```bash
pip install ansys-mapdl-mcp
```

Or run directly without installing using [`uvx`](https://docs.astral.sh/uv/):

```bash
uvx --from git+https://github.com/ansys/pymapdl-mcp ansys-mapdl-mcp
```

### For developers

```bash
git clone https://github.com/ansys/pymapdl-mcp.git
cd pymapdl-mcp
pip install -e .[tests]
```

## Usage

For step-by-step setup instructions for VS Code, Claude Code, Claude Desktop, and other
MCP-compatible clients, see the
[IDE and Client Configuration](https://mapdl-mcp.docs.pyansys.com/getting_started/ide_configuration.html)
page in the documentation.

## License

This project is licensed under the Apache 2.0 license agreement. See the [LICENSE](./LICENSE) file for details.

## Resources

- [PyMAPDL-MCP documentation](https://mapdl-mcp.docs.pyansys.com)
- [PyMAPDL Documentation](https://mapdl.docs.pyansys.com/)
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [FastMCP Documentation](https://github.com/jlowin/fastmcp)
- [Ansys MAPDL](https://www.ansys.com/products/structures/ansys-mechanical-apdl)
- [Repository's Issues page](https://github.com/ansys/pymapdl-mcp/issues)
- [Repository's Discussions page](https://github.com/ansys/pymapdl-mcp/discussions)

For general PyAnsys questions, email [pyansys.core@ansys.com](mailto:pyansys.core@ansys.com).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ansys](https://github.com/ansys)
- **Source:** [ansys/pymapdl-mcp](https://github.com/ansys/pymapdl-mcp)
- **License:** Apache-2.0
- **Homepage:** http://mapdl-mcp.docs.pyansys.com/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ansys-pymapdl-mcp
- Seller: https://agentstack.voostack.com/s/ansys
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.