NetLogo MCP

Name: NetLogo MCP
Author: Razee4315

by Razee4315version 1.0.2i★ –iRuns on your computer

Registry nameio.github.Razee4315/netlogo-mcp

Install

Overview

Description from the maker (original English)

Create, run, and analyze NetLogo agent-based models through natural conversation

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other
You need to fill in: NETLOGO_HOME, JAVA_HOME

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: NETLOGO_HOME, JAVA_HOME, NETLOGO_GUI

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "netlogo": {
      "command": "uvx",
      "args": [
        "netlogo-mcp"
      ],
      "env": {
        "NETLOGO_HOME": "your-value",
        "JAVA_HOME": "your-value",
        "NETLOGO_GUI": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add netlogo --env NETLOGO_HOME=your-value --env JAVA_HOME=your-value --env NETLOGO_GUI=your-value -- uvx netlogo-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "netlogo": {
      "command": "uvx",
      "args": [
        "netlogo-mcp"
      ],
      "env": {
        "NETLOGO_HOME": "your-value",
        "JAVA_HOME": "your-value",
        "NETLOGO_GUI": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "netlogo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "netlogo-mcp"
      ],
      "env": {
        "NETLOGO_HOME": "your-value",
        "JAVA_HOME": "your-value",
        "NETLOGO_GUI": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

NETLOGO_HOME required env
Path to the NetLogo 7.0+ installation directory (e.g. C:/Program Files/NetLogo 7.0.3)
JAVA_HOME required env
Path to a Java JDK 11+ installation (not a JRE)
NETLOGO_GUI env
Set to false for headless mode (no NetLogo window); default true

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account Razee4315, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 18336 servers in this category
Published to the registry more recently than 10% of the other 18336 servers in this category
Basic checks equal to or better than 100% of the other 18336 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is NetLogo MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: NETLOGO_HOME, JAVA_HOME

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.0.2) reached the registry 5 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, NexusWindows

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated 2 days ago

Install

NexusWindows

by pironjulien

Windows computer use in the background: desktop apps driven without your mouse or keyboard.

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

The first MCP (Model Context Protocol) server for NetLogo — enabling AI assistants to create, run, and analyze agent-based models through natural conversation.

Works with: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code (Copilot), Cline, Continue, Roo Code, Zed, OpenCode, Codex — any tool that supports MCP.

Why NetLogo MCP?

As an AI student taking an Agent-Based Modeling course, I searched for an MCP server to control NetLogo — nothing existed. So I built one.

Instead of manually writing NetLogo code, clicking buttons, and tweaking sliders, you tell your AI assistant what you want in plain English:

"Create a predator-prey model with 100 sheep and 20 wolves. Run it for 500 ticks and show me the population dynamics."

The AI writes the code, runs the simulation, and shows you the results — all through conversation.

By default a real NetLogo window opens (on first use) so you can watch your simulations run live. Headless mode is available for CI or servers.

Features

Create models from code — with real interface widgets: sliders, switches, buttons, monitors
Run simulations and collect tick-by-tick data as markdown tables
Run BehaviorSpace experiments — parallel parameter sweeps via the headless launcher
Export the view as PNG — visible inline in chat
Inspect everything — world state, agent samples, patch grids for heatmaps
CoMSES Net integration — search and safely run models from the largest peer-reviewed ABM library
Built-in references — NetLogo primitives, programming guide, and 6→7 transition guide as MCP resources
Lazy startup — the NetLogo window only opens when you actually use a tool, not when your AI client connects

See docs/TOOLS.md for the full reference of all 25 tools, widget schema, and prompts.

Prerequisites

Requirement	Install via terminal?	How
Python 3.10+	Yes	Windows: `winget install Python.Python.3.12` · macOS: `brew install python@3.12` · Linux: `sudo apt install python3.12`
Java JDK 11+	Yes	Windows: `winget install EclipseAdoptium.Temurin.21.JDK` · macOS: `brew install --cask temurin` · Linux: `sudo apt install openjdk-21-jdk`
NetLogo 7.0+	No — manual	Download from ccl.northwestern.edu/netlogo

Only NetLogo requires manual download. Everything else can be installed via terminal, and the Zero-Config Setup prompt below handles those automatically.

Zero-Config Setup (Recommended)

If you're using an AI coding tool, copy the prompt below into your chat. The AI will detect your OS, find your NetLogo and Java installations, clone the repo, install dependencies, configure your MCP client, and tell you how to use it.

Click to copy the setup prompt

Please set up the NetLogo MCP server for me end-to-end. Follow these steps carefully:

Detect my environment

Identify my OS (Windows / macOS / Linux).
Check Python version (need 3.10+). If missing, tell me to install it first and stop.
Check for Java JDK 11+ (not JRE). Look in common locations (JAVA_HOME env var, standard install dirs). If missing, tell me to install Adoptium Temurin JDK 11+ and stop.
Check for NetLogo 7.0+. Look in common locations:
Windows: C:/Program Files/NetLogo*
macOS: /Applications/NetLogo*
Linux: /opt/netlogo*, ~/netlogo* If NetLogo isn't installed, tell me to download it from https://ccl.northwestern.edu/netlogo/download.shtml and stop.

Install

Run: pip install netlogo-mcp
Verify the netlogo-mcp command is now available on my PATH.

Identify my MCP client

Figure out which AI tool I'm using (Claude Code, Cursor, Windsurf, Cline, Continue, Roo Code, Zed, OpenCode, VS Code Copilot, Codex, or Claude Desktop).
If you're not sure, ask me.

Configure the MCP client

Locate (or create) the correct config file for my client (see https://github.com/Razee4315/NetLogo-MCP/blob/main/docs/CLIENTS.md for exact paths and schemas per client).
Add a netlogo server entry with:
command: netlogo-mcp
env.NETLOGO_HOME: the NetLogo path you detected
env.JAVA_HOME: the JDK path you detected
Use the exact JSON schema for my specific client (e.g. "type": "stdio" for Cursor, "servers" key for VS Code).
Preserve any existing config entries — merge, don't overwrite.
IMPORTANT: configure it for THIS project only (project-scope config file), not globally, unless I say otherwise — a global entry loads the server in every session.

Tell me what to do next

Tell me to fully restart my AI tool for the new MCP server to load.
Tell me the NetLogo window opens on the FIRST model tool call, and that call takes 30–60 seconds while the Java Virtual Machine starts. Tell me NOT to click stop during this wait.
Give me this exact test prompt to try after restart:

"Create a simple predator-prey model with wolves and sheep on a green landscape. Run setup, then run 100 ticks while tracking wolf and sheep counts. Export the view before and after so I can see how the world evolved."

Tell me where models and exports are saved (by default, the current working directory's models/ and exports/ folders) and that I can browse them with the list_models tool.

Do not skip any verification step. If something fails, stop and tell me exactly what failed and how to fix it.

Manual Installation

pip install netlogo-mcp

Then add the server to your MCP client. For Claude Code, add to your project's .mcp.json:

"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" } } } }

Restart Claude Code and verify with /mcp.

Tip: prefer project-scope config (.mcp.json in one project) over global config — a global entry loads the server in every session of every project.

Using Cursor, Windsurf, VS Code, Cline, Continue, Roo Code, Zed, OpenCode, Codex, or Claude Desktop? See docs/CLIENTS.md for exact config for all 11 clients. All configuration options (GUI/headless mode, directories, limits) are in docs/CONFIGURATION.md.

Developing or contributing? Clone the repo and install editable instead:

git clone https://github.com/Razee4315/NetLogo-MCP.git

cd NetLogo-MCP pip install -e ".[dev]"

Docker

The image bakes in NetLogo (headless) with its bundled JRE — no host install needed:

docker build -t netlogo-mcp .

docker run -i --rm netlogo-mcp

MCP client config:

"mcpServers": { "netlogo": { "command": "docker", "args": ["run", "-i", "--rm", "netlogo-mcp"] } } }

Docker runs headless only (no GUI mode). Add -v ./exports:/data/exports to keep exported views and worlds on the host.

Quick Start

Once connected, try these prompts in any MCP client:

> Create a simple NetLogo model with 50 turtles doing a random walk.

Run setup, simulate 100 ticks, and export the view.

Open the Wolf Sheep Predation model and run a parameter sweep

on initial-number-wolves from 10 to 100.

Build a disease spread model with sliders for population size and

infection chance.

The first model tool call takes 30-60 seconds while the JVM starts — the NetLogo window appears when it's ready. Don't click stop. Every call after that is instant.

Troubleshooting

Problem	Solution
`NETLOGO_HOME is not set`	Set the environment variable to your NetLogo install directory
`JAVA_HOME is not set`	Set it to your JDK directory (not JRE)
JVM crashes on startup	Make sure JAVA_HOME points to JDK 11+, not an older version
`No model is loaded`	Call `open_model` or `create_model` before using other tools
First model call hangs for 30-60s	Normal — JVM is warming up. Don't click stop.
NetLogo window opens when my AI client starts	You have `NETLOGO_EAGER_START=true` set, or an old version — by default the window only opens on first tool use
Server won't connect	Run `netlogo-mcp` manually in terminal to see error output

Documentation

docs/TOOLS.md — Full tool reference, widget schema, BehaviorSpace & CoMSES guides
docs/CONFIGURATION.md — All environment variables, GUI vs headless, startup timing
docs/SECURITY.md — Security model and trust boundary
docs/CLIENTS.md — Setup for all 11 MCP clients
docs/DEVELOPMENT.md — Project structure, running tests, architecture notes
CONTRIBUTING.md — How to contribute
CHANGELOG.md — Version history

Listed on

Citing

If you use NetLogo MCP in research or teaching, please cite it — click "Cite this repository" in the GitHub sidebar, or see CITATION.cff.

Author

Saqlain Abbas Email: saqlainrazee@gmail.com GitHub: @Razee4315 LinkedIn: @saqlainrazee

License

This project is licensed under the MIT License — free to use, modify, and distribute for any purpose.

NetLogo MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

NexusWindows

README from the maker

Why NetLogo MCP?

Features

Prerequisites

Zero-Config Setup (Recommended)

Manual Installation

Docker

Quick Start

Troubleshooting

Documentation

Listed on

Citing

Author

License