Skip to main content
Glama
Ciltress

Skyrim Modding Tools MCP

by Ciltress
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

skyrim-modding-tools-mcp

An MCP server for Skyrim Special Edition modding with Mod Organizer 2 on Windows, or Amethyst Mod Manager on Linux. It lets an AI agent look records up across your whole load order — who defines a sword, which mods change it, and how — and author mods and patches as text: records are YAML files in a git-versioned project, built into a plugin and deployed into the mod manager. The Creation Kit stays for what only it can do (placing objects, navmesh); its work is pulled back into the text.

Plugins are read and written by Mutagen; the text is Spriggit's format.

What it offers

Tool

Does

findRecords

Search the active load order by name or editor ID; resolve FormIDs to names and back

readRecord

One record as project text — the winning version, one plugin's, or every version side by side

newProject

Start a new mod

addPatch

Copy existing records into a patch as overrides, from their winning version, to change them without touching the original mod

buildProject

Text → plugin: assigns FormIDs to new records, checks every reference, compiles Papyrus scripts

deployProject

Build → Mod Organizer: mod folder, enabled, plugin at the end of the load order

pullProject

Changes made in the Creation Kit or xEdit → back into the text

searchNexus

Find Skyrim SE mods on Nexus Mods by name, or list the most endorsed, downloaded or updated — with an API key

readNexusMod

One Nexus mod page: description, requirements (SKSE, other mods, DLC), the files it offers — with an API key

downloadNexusFile

A file of a Nexus mod into the instance's downloads folder — with a premium account's API key

installMod

A downloaded file → a mod: unpacked, its FOMOD installer answered, enabled, its plugins active

Plus healthcheck, and the server's own guides (readServerGuide) and modding skills (readSkill): how plugins, FormIDs, load order and conflicts work, the community's tools, and one reference per record family — items and crafting, magic, NPCs, leveled lists.

Related MCP server: API MCP Server

Requirements

  • Node.js 24, git (with Git LFS for project assets)

  • Skyrim Special Edition 1.5.97 to 1.7.x, managed by

    • Mod Organizer 2 (2.5) on Windows, or

    • Amethyst Mod Manager (2.5) on Linux — set SKYRIM_MOD_MANAGER=amethyst; the setup is in docs/Hosting.md §4. Mod Organizer under Proton is experimental (§5).

  • The .NET 10 SDK to build the plugin helper; the .NET 10 runtime to run it

  • For compiling Papyrus scripts (optional otherwise): the Creation Kit (free on Steam) for its vanilla script sources, and a compiler — on Windows the Creation Kit's own, which needs .NET Framework 3.5 (Windows Features); on Linux russo-2025's papyrus-compiler

Setup

git clone <this repository>
cd skyrim-modding-tools-mcp
npm install
npm run build:helper   # the .NET plugin helper -> helper/bin
npm run build          # the server -> dist/
copy .env.example .env # then set SKYRIM_MO2_INSTANCE — or SKYRIM_MOD_MANAGER=amethyst

Register it with a client — Claude Code, Claude Desktop, VS Code:

{
  "mcpServers": {
    "skyrim": {
      "command": "node",
      "args": ["C:/path/to/skyrim-modding-tools-mcp/dist/index.js"],
      "env": { "SKYRIM_MO2_INSTANCE": "G:\\Modding\\SkyrimSE-Test" }
    }
  }
}

Then ask healthcheck whether it found your instance, profile and game version.

Work on a test instance. Deploys write into the instance's mods and profile. A dedicated portable Mod Organizer on a clean game is the safe place to learn the tools — and if your instance was installed by Wabbajack, an update deletes every mod it did not install.

Configuration

See .env.example.

Variable

Default

Effect

SKYRIM_MOD_MANAGER

mo2

mo2 (Mod Organizer 2) or amethyst (Amethyst Mod Manager, Linux)

SKYRIM_MO2_INSTANCE

— (required with mo2)

The Mod Organizer instance folder; the server follows its selected profile

SKYRIM_WINE_PREFIX

found by itself for MO2-LINT

Mod Organizer under Proton: the Wine prefix it runs in, to read its ini's Windows paths

SKYRIM_AMETHYST_DIR

found by itself

Amethyst's config folder, if it is neither the Flatpak's nor ~/.config's

NEXUS_API_KEY

none

Your personal Nexus Mods API key; healthcheck shows its account. Without it the Nexus tools are not offered; downloadNexusFile is offered only when Nexus confirms a premium account

SKYRIM_PROJECTS_DIR

./projects

Where projects live

SKYRIM_CK_DIR

the instance's game folder

The Creation Kit, for its Papyrus compiler and vanilla script sources

SKYRIM_PAPYRUS_COMPILER

the Creation Kit's (Windows); none (Linux)

PapyrusCompiler.exe, or russo-2025's papyrus-compiler, which runs on Linux

SKYRIM_HELPER_PATH

helper/bin/SkyrimHelper(.exe)

The built plugin helper

MCP_PROFILE

all

core, readonly or all — which tools are listed and callable

MCP_MAX_RESPONSE_BYTES

per profile

Ceiling on one answer; 0 removes it

MCP_TRANSPORT

stdio

http for Streamable HTTP at /mcp — see docs/Hosting.md

SKYRIM_ACCEPTED_TOKENS

none

HTTP mode: the bearer tokens callers may present

Documentation

Document

For

docs/Tool-Router.md

Which tool does what, in the words people use

docs/MCP-Tools.md

How the server behaves: rules, architecture, workflows, errors, troubleshooting

docs/Tool-Reference.md

Every tool and argument — generated, never edited by hand

skills/

The modding knowledge the server serves to agents

CONTEXT.md, docs/adr

Vocabulary and design decisions

docs/research

The research the design rests on

AGENTS.md

Working on this code

docs/Hosting.md

stdio, Streamable HTTP, Docker

The guides are served to clients too: ask the running server with readServerGuide.

Development

npm run build:helper   # dotnet publish helper/SkyrimHelper -> helper/bin
npm run build          # tsc -> dist/
npm test               # vitest, fully offline: no game, no helper needed
npx tsc --noEmit       # type check only
npm run docs:tools     # regenerate docs/Tool-Reference.md after changing a tool (needs a build)
npm run smoke          # the built server over real stdio

License

GPL-3.0 — see LICENSE. The plugin engine, Mutagen, is GPL-3.0; ADR-0006 explains why the whole project follows it. Copyright © 2026 Andreas Breit; co-authored with Claude (Anthropic).

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers