NetLogo MCP

Name: NetLogo MCP
Author: Razee4315

@Razee4315

About NetLogo MCP

The first MCP server for NetLogo, the most widely used agent-based modeling platform. Lets AI assistants create models with real interface widgets, run simulations and BehaviorSpace parameter sweeps, export world views as PNG, and safely run peer-reviewed models from the CoMSES N

#netlogo #agent-based-modeling #simulation #research #complexity-science #behaviorspace

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "netlogo": {
      "command": "netlogo-mcp",
      "args": [],
      "env": {
        "NETLOGO_HOME": "C:/Program Files/NetLogo 7.0.3",
        "JAVA_HOME": "C:/Program Files/Eclipse Adoptium/jdk-25.0.2.10-hotspot"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is NetLogo MCP?

NetLogo MCP is a Model Context Protocol server for NetLogo, the most widely used agent‑based modeling platform. It provides 25 tools for creating models with interface widgets (sliders, switches, buttons, monitors, live plots), running simulations and collecting tick‑by‑tick data, performing headless BehaviorSpace parameter sweeps, exporting the world view as PNG, and integrating with the peer‑reviewed CoMSES Net model library. It supports GUI (live simulation watching) and headless modes and runs on Windows, macOS, and Linux. It is designed for researchers, educators, and students in complexity science, ecology, economics, and social science.

How to use NetLogo MCP?

Install the package via pip install netlogo-mcp. Requires Python 3.10+, a NetLogo installation, and a JDK 11+. A zero‑config setup script and per‑client configuration for tools like Claude Code, Claude Desktop, and Cursor are detailed in the README. Use example prompts such as “Create a simple NetLogo model with 50 turtles doing a random walk. Run setup, simulate 100 ticks, and export the view” to interact with the server.

Key features of NetLogo MCP

Create models with real interface widgets: sliders, switches, buttons, monitors, live plots
Run simulations and collect tick‑by‑tick data from agents and patches
BehaviorSpace parameter sweeps — headless, parallel experiment runs
Export the world view as PNG, displayed inline in chat
CoMSES Net integration — search and safely run peer‑reviewed models
GUI mode (watch live) and headless mode; 25 tools total

Use cases of NetLogo MCP

Teach agent‑based modeling by creating and running simple random‑walk models interactively
Perform parameter sensitivity analysis on published models (e.g., Wolf Sheep Predation) using BehaviorSpace sweeps
Visually export simulation states for reports or presentations
Explore and execute models from the peer‑reviewed CoMSES Net library
Automate model runs and data collection in research workflows