MCP.Market

NetLogo MCP server

by Razee4315·io.github.Razee4315/netlogo-mcp·v1.0.2·27 stars
No reviews yet

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

A88/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
Growing

27 stars24 downloads/wk

Reviews

Write one

Nobody has reviewed NetLogo MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

NetLogo MCP tools (25, 7 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • close_model

    Unload the currently loaded model and reset the workspace.

  • commandwrite action

    Execute a NetLogo command (e.g. 'setup', 'go', 'create-turtles 10').

  • create_modelwrite action

    Create a new NetLogo model from code and load it.

  • download_comses_model

    Download and safely extract a COMSES model archive.

  • export_view

    Export the current NetLogo view as a PNG image.

  • export_world

    Export the full world state to a CSV file.

  • get_agent_sample

    Return a sample of agents with selected variables as a markdown table.

  • get_comses_model

    Get detailed metadata for a specific CoMSES model.

  • get_patch_datawrite action

    Get patch data as a 2D grid (useful for heatmaps / spatial analysis).

  • get_world_state

    Get the current world state: tick count, agent counts, world dimensions.

  • list_experiments

    List BehaviorSpace experiments saved inside a NetLogo model file.

  • list_models

    List all .nlogo model files in the configured models directory.

  • open_comses_model

    Download (or reuse cache), then open a COMSES model ready to use.

  • open_model

    Open an existing .nlogo model file.

  • preview_experiment

    Show the run plan for a BehaviorSpace experiment WITHOUT executing it.

  • read_comses_files

    Return text contents of source and documentation files from a downloaded COMSES model.

  • report

    Evaluate a NetLogo reporter expression and return its value.

  • run_experimentwrite action

    Run a BehaviorSpace experiment headlessly and return summarized results.

  • run_simulationwrite action

    Run the simulation for N ticks and collect reporter data each tick.

  • save_model

    Save NetLogo model code to a .nlogox file in the models directory.

  • search_comses

    Search the CoMSES Net computational model library.

  • server_info

    Return a snapshot of the running NetLogo MCP server's configuration.

  • set_parameter

    Set a NetLogo global variable / slider / switch value.

  • update_modelwrite action

    Update the currently loaded model's code in place and reload it.

  • watch_simulationwrite action

    Run the simulation SLOWLY so a human can watch it in the GUI window.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan13 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 57 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How NetLogo MCP compares

Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 80% of 4,460 AI and agents servers
Tools
25
the typical AI and agents server has 6
Tools that change things
28%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
27
more than 90% of 2,711 AI and agents servers
Downloads a week
24
more than 10% of 1,538 AI and agents servers with a package

What its tools let an agent do: 13 read · 4 create · 6 change · 2 run or deploy

Install NetLogo MCP in Claude Code, Cursor or VS Code

claude mcp add netlogo-mcp -- uvx netlogo-mcp
Add to Cursor

What the publisher says

From the NetLogo MCP repository's README, as published. We do not edit it. Read it on GitHub

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

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)

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

NetLogo MCP: common questions

Is NetLogo MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the NetLogo MCP safety report
How do I install NetLogo MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does NetLogo MCP need an API key?
No secret keys are declared. It reads 3 settings from the environment.
Is NetLogo MCP maintained?
The last commit was 95 days ago (2026-08-01). The latest release is v1.0.2.
How does NetLogo MCP compare with other AI and agents MCP servers?
safety score 88/100 (higher than 80% of 4,460 AI and agents servers); tools 25 (the typical AI and agents server has 6); tools that change things 28% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.