FiveM MCP
Build, run and live-test FiveM servers with AI agents: RCON, DevCon, window control, mcpb bridge.
Connector by ziyacivan · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/ziyacivan-fivem-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 8 read · 11 write · 4 delete
- Secrets
- 2 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 23
Read from the source code; the running server may list different tools.
Read 8 · Look things up without changing anything.
list_commandsread_client_logread_consoleserver_infostatuswaitwait_for_consolewindow_status
Write 11 · Create, change, send or run things.
clickfocus_windowhold_keylaunchmouse_movepress_keyrelease_keyrestore_focusscreenshotscrolltype_text
Delete 4 · Delete, drop, revoke or wipe things.
bridgeclient_commandquit_gameserver_command
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
FIVEM_MCPB_TOKENFIVEM_RCON_PASSWORD
Other settings (environment variables or headers).
FIVEM_CLIENT_DEVCON_PORTFIVEM_COMMAND_TIMEOUT_MSFIVEM_CONSOLE_CAPACITYFIVEM_EXECUTABLEFIVEM_HOSTFIVEM_MCP_DEBUGFIVEM_QUIET_MSFIVEM_RCON_ADDRESSFIVEM_SERVER_LOG
Network hosts it talks to 2
biomejs.dev· found in codegithub.com· found in code
Files it touches
- Your home directory (~)
Tools (23)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
bridgeInvoke a bridge operation (mcpb resource)can change or delete dataRuns an operation through the mcpb bridge resource — the half neither devcon nor RCON can reach. Server ops (target=server): ping, players, poll, call_export, trigger_event, wait; call_export {resource, method, args}, trigger_event {event, args, toClient?, player?} (event names must be in mcpb_event_allowlist). Client ops (target=client, needs src): ping, position, teleport, freeze, call_native, send_nui, nui_callback; teleport {x,y,z,heading?}, freeze {freeze}, call_native {name, args}, send_nui {resource, message, event?}, nui_callback {resource, endpoint, payload}. Client results are collec…
clickMouse clickClick at the current cursor position (position it with mouse_move absolute first for NUI).
client_commandRun a FiveM client (F8) console commandcan change or delete dataType a LOCAL console command into the running Legacy client's F8 console over devcon — no screen focus needed, nothing is typed into the game window. This is the process's console context (connect, quit, tooling commands), NOT the chat command layer: commands registered with RegisterCommand are chat commands and live in a different system (run them through server_command, which has console privileges, or drive the chat UI with the M2 input tools). Waits until output goes quiet and returns the lines the client console printed.
focus_windowBring the game to the foregroundRestores/minimizes-out if needed and steals foreground (remembering the previous window for restore_focus). Every input/screenshot tool calls this automatically.
hold_keyHold a key downKey stays pressed until release_key. Use for movement (W) and camera. Key name: W A S D E F Q space enter esc tab shift ctrl alt arrows up down left right, f1-f12, letters/digits. Held keys are released if this process exits.
launchStart the FiveM clientLaunch FiveM, optionally straight into a server via the fivem://connect link. Default target is the configured game port. Returns immediately — watch window_status/client_command to see when the game is up.
list_commandsList client console commandsread-onlyThe devcon handshake streams every command the client console knows (CVAR frames). For server commands, run 'help' through server_command instead. Filter with a case-insensitive substring.
mouse_moveMove the mouseRelative dx/dy drives the in-game camera; absolute x/y (screen pixels) positions the real cursor for NUI elements.
press_keyTap a keyPress and release a key (scan codes — what GTA's DirectInput/raw input reads). Key name: W A S D E F Q space enter esc tab shift ctrl alt arrows up down left right, f1-f12, letters/digits.
quit_gameClose the FiveM clientcan change or delete dataGraceful path: prints 'quit' to the client console over devcon and waits for the game to close (nothing is typed into the window). force: true kills the FiveM process tree instead — use it only when the game is wedged.
read_client_logRead the FiveM client log fileread-onlyTail the newest CitizenFX_log_*.log under the FiveM install — the same stream as read_console(client) but persisted across sessions, without the channel tags.
read_consoleRead recent console outputread-onlyDescription is built at runtime.
release_keyRelease held key(s)Release one held key, or all of them with key='all'.
restore_focusGive focus back to the previous windowReturns foreground to whatever window was focused before this tool focused the game.
screenshotCapture the game windowPNG of the FiveM window (PrintWindow with PW_RENDERFULLCONTENT; falls back to a screen BitBlt of the window rect when the swapchain returns black, which means whatever covers the window is also captured — the game is focused first). Downscaled so vision models can read it cheaply. COST WARNING: every screenshot stays in the transcript and is re-sent on every later turn - many shots multiply session latency. Prefer text probes (read_console, wait_for_console, bridge ops); when pixels are the evidence, keep maxSide small (640 suffices for layout checks) and crop to the panel of interest.
Show 8 more tools
scrollMouse wheelScroll the wheel (positive = up). NUI lists respond to it.
server_commandRun an FXServer console commandcan change or delete dataExecute a command on the server console over UDP RCON (any command the console accepts: ensure/stop/restart, convars, registered commands). The reply carries the command's captured console output. Needs `rcon_password` on the server and FIVEM_RCON_PASSWORD here; rate-limited server-side (~5 burst).
server_infoQuery server identity (no credentials)read-onlyAsk the server's getinfo out-of-band endpoint: hostname, players online, max clients, protocol, game build. Works without rcon_password; use it to confirm which server you are pointed at.
statusConnection statusread-onlyReport RCON configuration for the server, the devcon connection to the FiveM client console, and the server log-file tailer. Call this first.
type_textType literal textSends Unicode key events — the F8 console and chat/NUI inputs read these normally. Open the target input first (e.g. client_command to focus, or a chat key like T). Does not press Enter.
waitPauseread-onlySleep between actions — loading screens, walk cycles, held-key sequences.
wait_for_consoleWait for a console line to appearread-onlyBlock until a line matching a regex appears. 'client' watches the live devcon stream; 'server' polls FIVEM_SERVER_LOG for newly written lines (only lines appended after the call count). Use after a fire-and-forget command, to watch for a resource's startup banner, an error, or a scripted RESULT: line.
window_statusGame window stateread-onlyWhether the FiveM game window exists, its title/pid, on-screen rect, and whether it is the foreground window. Input/screenshot tools focus it automatically.
Signals
- Stars
- 17
- Forks
- 1
- Open issues
- 0
- Last commit
- Sep 4, 2026 (1 month ago)
- Last release
- Sep 4, 2026 (1 month ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.ziyacivan/fivem-mcp- Version
- 0.6.0
- Auth
- API key
- Packages
- npm fivem-mcp-server
- License
- MIT
- Repository
- github.com/ziyacivan/fivem-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
FiveM MCP. Agent Mart. https://agentmart.dev/connectors/ziyacivan-fivem-mcp (last updated 2026-10-24)