Point the MCP server to a SAMP project directory. Automatically detects config and tracks the project.

Execute a command on the SAMP server via RCON

Get current server statistics (hostname, players, map, etc.)

Get the current list of players (ID, Name, Score, Ping)

Get current server rules (gravity, weather, version, etc.)

Compile a Pawn script and attempt to load it into the server. This will restart the server.

Read the last N lines of the SAMP server_log.txt

Search for specific keywords (e.g., 'Error', 'Crash', 'Failed') in server_log.txt

Analyze server logs for common issues (Crash signatures, Plugin load failures, etc.)

Read the SAMP server.cfg configuration file.

Write/Update the entire SAMP server.cfg configuration file.

Update a specific key in server.cfg (e.g., 'hostname', 'maxplayers').

List files in a SAMP server subdirectory (gamemodes, plugins, include, etc.) Use this to find .pwn and .inc source files.

MANDATORY: ALWAYS use this for .pwn/.inc files. It is the ONLY safe way to handle encoding and language. Standard tools WILL corrupt files. Optionally read only a specific line range (1-indexed).

MANDATORY: ALWAYS use this for .pwn/.inc files. It is the ONLY safe way to handle encoding and language. Standard tools WILL corrupt files. CRITICAL: When replacing a line range, ALWAYS provide BOTH startLine AND endLine. Providing only startLine replaces only that single line.

Search for text inside .pwn/.inc files across the entire project. Returns file paths, line numbers, and surrounding context. Much more efficient than reading entire files.

Find .pwn/.inc/.cfg files by partial name match. Useful when you can't remember the exact file path.

Extract the complete body of a function by name from a .pwn/.inc file. Much more efficient than reading the entire file. Returns only the function code with optional doc comments.

Restore a .pwn/.inc file from its latest backup (or a specific backup). Use this as 'undo' when a write goes wrong.

List available backups for a specific file or all files in the project.

Fix encoding corruption in a .pwn/.inc file. If another AI saved Thai text as UTF-8 (causing garbled characters like ยยกต), this tool converts it back to the correct Windows-874 encoding.

Compile a .pwn script using pawncc.exe. Returns structured error/warning list.

List available .inc files in pawno/include and other common paths.

Read a .inc file from the include directories (Thai support).

Generate SAMP code snippets. Automatically detects if the project is Thai and provides Thai strings if so. DO NOT TRANSLATE generated Thai strings.

Get the coding standards and patterns for the currently connected SAMP project.

Get a list of high-quality, popular SA-MP libraries and plugins from GitHub topics.

Get a summary of the project size, line counts, and estimated command/dialog counts.

Scan a .pwn or .inc script for potential issues (Large arrays, Hardcoded IDs, etc.)

Perform a quick RCON action on a player (kick, ban, mute)

Generate a markdown summary of all commands and dialogs in the project.

Scan the project for #include statements that point to missing files.

Scan a script for potential variable shadowing (e.g., redefining playerid).

Create a temporary Filterscript with the given code and compile it (Hot Injection).

Scan a script for potential SQL Injection risks (missing %e in mysql_format).

Batch copy all necessary server files (AMX, Plugins, CFG) to a distribution folder.

Search the official SAMP Wiki and Forum Archive for information/examples.

Get a common SAMP code snippet for various systems (MySQL, Login, Vehicle, etc.)

Clone and refactor a script (e.g. Juice -> Watermelon). MANDATORY for Thai projects to preserve encoding. DO NOT TRANSLATE Thai strings during transformation.

Download and install a SAMP plugin (.dll/.so) and update server.cfg. Supports GitHub repos (e.g. 'IS4Code/YSF') or direct download URLs.

Search for SAMP plugins on GitHub by name. Returns repos and available release binaries.

Search the web for general information. Useful for answering questions about SA-MP versions, plugins, game mechanics, etc.

Scan a script for potential performance issues (fast timers, heavy OnPlayerUpdate logic).

Download and install a .inc library from a URL (e.g. GitHub raw) into pawno/include.

Scan a script for all string literals. Useful for localization or cleanup.

Get a real-time summary of server health, players, and performance.

Start, Stop or Restart the SAMP server process

Check if a new version of SAMP-MCP is available on NPM.

Perform a self-update of the SAMP-MCP server via NPM.

Before implementing ANY new system, create a structured plan with edge case analysis. The plan is shown to the user inline for review. WAIT for explicit user confirmation before writing code.

After implementing a feature, verify that the plan checklist is satisfied and all expected files exist.

CRITICAL: Call this FIRST. Returns the mandatory encoding and language rules for this specific SAMP project.

MANDATORY SETUP: Call this to install .cursorrules and SAMP_RULES.md into your SAMP server root. This forces AI agents (Cursor, Windsurf, etc.) to use the correct tools and maintain encoding.