PWS MCP Server

PWS MCP Server connects an AI assistant to the save currently loaded in Pro Wrestling Sim.

Ask it to search your save, analyze your company, review contracts, recommend workers, plan storylines, or draft and apply complete show cards. Read-only questions do not change your save. Save-changing actions require confirmation and are validated by PWS.

Table of contents

• What you need

• Install the PWS plugin

• Connect Claude Desktop

• Connect Claude Code

• Connect Codex

• Connect another MCP client

• Test the connection

• Ideas to try

• Booking API notes

• Safety

• Troubleshooting

• Current limitations

• License

Related MCP server: WordPress MCP Server

What you need

• Windows and Pro Wrestling Sim

• The PWS MCP Server in-game plugin

• One supported local AI client

• An account or billing setup for that AI client

This plugin provides the connection to PWS, but it does not include an AI model or subscription. Claude Desktop's Code tab and Claude Code require an eligible paid Claude plan, or pay-as-you-go Claude API billing. Codex requires a ChatGPT account; the Free plan is supported, while paid ChatGPT plans provide more Codex usage. Usage limits from your chosen plan still apply.

Claude Desktop users do not need to install Node.js or edit a configuration file. The downloadable MCPB includes the Claude-side server and uses Claude Desktop's built-in Node runtime.

Node.js 18 or newer is still required for Codex, Claude Code, and other clients that run the Workshop copy of mcp-server.js directly.

Install the PWS plugin

Steam Workshop (recommended)

1. Subscribe to PWS MCP Server in the Steam Workshop.

2. Wait for Steam to finish downloading it.

3. Restart Pro Wrestling Sim.

4. Enable PWS MCP Server in the plugin list on the splash screen.

5. Load the save you want the AI to use.

The plugin works in the background and does not add an in-game page.

Manual GitHub installation

Use this only when you are not installing through Steam Workshop.

1. Download the repository ZIP from GitHub and extract it.

2. Rename the extracted folder to pws-mcp-server.

3. Copy it to %APPDATA%\ProWrestlingSimulator\plugins.

4. Restart PWS, enable the plugin, and load a save.

Connect Claude Desktop

Claude Desktop uses the one-click MCPB release. Do not edit claude_desktop_config.json.

Account requirement: The Code tab uses Claude Code and requires an eligible paid Claude plan, or pay-as-you-go Claude API billing.

1. Open the latest GitHub release.

2. Download pws-mcp-server-vVERSION.mcpb from Assets.

3. In Claude Desktop, open Settings > Extensions > Advanced settings.

4. Select Install Extension and choose the downloaded .mcpb file.

5. Start PWS, enable the plugin, and load a save.

6. Open the Code tab in Claude Desktop, start a new conversation, and confirm that Pro Wrestling Sim is enabled.

Use the Code tab, not the Home tab. Home conversations do not use MCP servers configured in Claude Code.

The MCPB installs only the Claude-side connection. The in-game plugin must still be installed through Steam Workshop or manually.

If your Claude organization blocks custom desktop extensions, an owner or administrator must allow them. See Anthropic's local MCP server guide.

Connect Claude Code

Account requirement: Claude Code requires an eligible paid Claude plan, or pay-as-you-go Claude API billing.

Install Node.js 18 or newer, then run this in PowerShell for a normal Workshop installation:

$server = 'C:\Program Files (x86)\Steam\steamapps\workshop\content\1157700\3780507815\plugins\pws-mcp-server\mcp-server.js'
claude mcp add --scope user pro-wrestling-sim -- node $server

If Steam is installed in another library, change the path. For a manual GitHub installation:

$server = Join-Path $env:APPDATA 'ProWrestlingSimulator\plugins\pws-mcp-server\mcp-server.js'
claude mcp add --scope user pro-wrestling-sim -- node $server

Check the connection with claude mcp list or /mcp inside Claude Code. See the Claude Code MCP documentation for client details.

Connect Codex

Account requirement: Codex requires a ChatGPT account. The ChatGPT Free plan supports Codex; paid plans provide higher usage limits.

Install Node.js 18 or newer. In Codex, open Settings > Plugins > Add > Add MCP Server, choose STDIO, and enter:

Name:     pro-wrestling-sim
Command:  C:\Program Files\nodejs\node.exe
Argument: C:\Program Files (x86)\Steam\steamapps\workshop\content\1157700\3780507815\plugins\pws-mcp-server\mcp-server.js

If Steam uses another library, change the argument path. Restart the MCP server after saving. You can also configure it from PowerShell:

$server = 'C:\Program Files (x86)\Steam\steamapps\workshop\content\1157700\3780507815\plugins\pws-mcp-server\mcp-server.js'
codex mcp add pro-wrestling-sim -- node $server

See the Codex MCP documentation for other installation methods.

Connect another MCP client

The server uses standard input/output (stdio). Configure your client to run:

node <complete path to mcp-server.js>

It is a local process, not a public HTTP service. Node.js 18 or newer is required outside the Claude Desktop MCPB.

Test the connection

Keep PWS open with a save loaded, then ask:

Connect to Pro Wrestling Sim and tell me the loaded save, current date, player promotion, company size, and cash balance.

If you are using Claude Desktop, ask this from the Code tab, not the Home tab.

If the answer contains information from your save, setup is complete.

Ideas to try

• "Assess my company and identify my three biggest roster needs."

• "Recommend five affordable hires who fit those needs."

• "Review all contracts expiring in the next year."

• "Show me my champions, active storylines, and neglected wrestlers."

• "Draft my next show, explain every choice, and wait for approval."

Booking API notes

Use titleIds: number[] to put championships on the line in a match. This is the only supported championship field; singular titleId and other unknown segment fields are rejected. Validation checks that each title is active, belongs to the player promotion, fits the show brand and match team size, and includes every reigning champion unless the title is vacant. Multiple titles are supported.

pws_apply_show_plan re-reads every created segment and verifies its participants, winner, runtime, title associations, and other requested booking fields. If verification fails, it reports failure and removes the new segments instead of returning a false success.

pws_update_segment previews by default. After reviewing before and proposed, call it again with the same changes, preview: false, and confirmed: true. The update uses a narrow field allowlist, one transaction, rollback, a post-save read, before/after output, and an audit entry. It does not expose general-purpose SQL writes.

Safety

• The bridge listens only on the local computer and uses a random authentication token.

• Raw database access is read-only and result-limited.

• The plugin's internal database-write permission is used only by purpose-built, allowlisted transactional actions such as pws_update_segment; no raw SQL-write tool is exposed.

• Save-changing actions are validated and audited by PWS.

• Show plans are drafts until you explicitly approve applying them.

• The assistant should never report a save change as successful unless PWS confirms it.

Back up important saves before using any plugin that can perform game actions. Never share %APPDATA%\ProWrestlingSimulator\mcp\pws-mcp-runtime.json; it contains a temporary local access token.

Troubleshooting

PWS bridge is offline

Start PWS, confirm the plugin is enabled, and load a save. If it was already open, restart PWS and then restart the AI client or extension.

Not connected in Claude

Open the Code tab and start the conversation there. Home conversations do not use MCP servers configured in Claude Code. Confirm Pro Wrestling Sim is enabled for the conversation. If the tools are still missing, restart Claude Desktop after installing or updating the MCPB, or reinstall the newest MCPB from GitHub Releases.

Workshop server file is missing

The default path is:

C:\Program Files (x86)\Steam\steamapps\workshop\content\1157700\3780507815\plugins\pws-mcp-server\mcp-server.js

If Steam uses another drive, locate its steamapps\workshop\content directory. This path check is not needed for Claude Desktop MCPB users.

Node is not recognized

This applies to Codex, Claude Code, and other direct stdio clients. Install Node.js LTS, restart Windows, and run node --version. Claude Desktop MCPB users do not need a separate Node installation.

An action is rejected

PWS validates game actions. Ask the assistant to explain the returned error and revise the request. Automatic show cards remain drafts until they pass validation and you approve them.

Current limitations

• Pro Wrestling Sim and its plugin API are Windows-only.

• Contract renewals remain advisory until PWS exposes a validated renewal action.

• Privately distributed MCPB updates must be downloaded and installed again from a newer GitHub Release.

License

Licensed under the Apache License 2.0. See LICENSE and NOTICE.