Skip to main content
Glama

FiveM Enhanced MCP

CI Security License: MIT Node.js 22+

An unofficial, source-grounded MCP server and Codex skill for professional development on FiveM for GTAV Enhanced.

It gives coding agents exact native lookups, current platform constraints, manifest and security reviews, NUI compatibility evidence, and direct primary sources. Unknown, stale, ambiguous, and conflicting facts remain explicit instead of being guessed.

IMPORTANT

This independent project is not approved, sponsored, endorsed, or maintained by Rockstar Games or Cfx.re. It supports GTAV Enhanced only and contains no Rockstar or Cfx.re brand assets.

Why this exists

FiveM answers are often technically plausible but wrong for the target product, runtime, API set, artifact, or gamebuild. Legacy guidance and third-party framework assumptions can make that worse. This project provides a deliberately narrow context layer that:

  • distinguishes GTAV Enhanced behavior from Legacy behavior;

  • resolves natives by exact name or hash and preserves client/server scope;

  • cites official Cfx.re or Rockstar-controlled sources directly;

  • validates resource structure, manifests, events, State Bags, and NUI targets;

  • treats remote content as untrusted data;

  • requires runtime evidence before calling code performant.

The MCP server supplies facts and diagnostics. The host agent still writes and edits code. v0.1 does not generate code, modify project files, administer a server, deploy resources, or download FiveM artifacts.

Related MCP server: mcdev-mcp

Product boundary

Included

Intentionally excluded

FiveM for GTAV Enhanced

FiveM Legacy and RedM

Framework-neutral resources

ESX, QBCore, ox_lib, and other frameworks

Client, server, shared, and NUI facts with explicit scope

Marketplace, escrowed, paid, leaked, or private resources

Official documentation, native declarations, and source metadata

Game assets, artifact binaries, and server administration

Read-only reviews and cache refresh

Code generation, filesystem changes, deployment, and administration

See ADR 0001 for the rationale.

Quickstart

Requirements

  • Node.js 22 or newer

  • npm 10 or newer

  • Git

A current Docker Desktop installation with MCP Toolkit enabled is optional for container or Docker MCP Gateway usage.

Run from source

git clone https://github.com/ghost-maxi/fivem-enhanced-mcp.git
cd fivem-enhanced-mcp
npm ci
npm run build
npm start

The server communicates over stdio. Standard output is reserved for MCP messages.

On Windows, use npm.cmd if PowerShell blocks npm.ps1.

Connect to Codex

Add the GitHub-backed marketplace and install the bundled plugin:

codex plugin marketplace add ghost-maxi/fivem-enhanced-mcp
codex plugin add fivem-enhanced-mcp@fivem-enhanced

Alternatively, build the project and register the absolute path to the compiled entry point:

codex mcp add fivem-enhanced -- node /absolute/path/to/fivem-enhanced-mcp/dist/index.cjs
codex mcp list

Restart the Codex app after changing MCP configuration. For the intended workflow, the plugin bundles the fivem-enhanced-engineering Codex skill with the MCP server. The skill guides source verification and review; the server provides typed evidence.

Run with Docker

docker build -t fivem-enhanced-mcp:local .
docker run --rm -i \
  --read-only \
  --tmpfs /tmp \
  --mount source=fivem-enhanced-cache,target=/data/cache \
  --env FIVEM_ENHANCED_MCP_CACHE_DIR=/data/cache \
  fivem-enhanced-mcp:local

Or use the checked-in Compose definition:

docker compose run --rm fivem-enhanced-mcp

Use Docker MCP Gateway

Docker MCP Toolkit supports local YAML server descriptors. From the repository root:

docker build -t fivem-enhanced-mcp:local .
docker mcp profile create --name fivem-enhanced --server docker://fivem-enhanced-mcp:local
docker mcp gateway run --profile fivem_enhanced --dry-run
docker mcp client connect codex --global --profile fivem_enhanced

Review the dry-run output before connecting. Keep this profile limited to the expected server. See the full Docker MCP Gateway runbook.

Configuration

All settings are optional:

Variable

Purpose

Default

FIVEM_ENHANCED_MCP_CACHE_DIR

Local normalized source cache

Platform cache directory

FIVEM_ENHANCED_MCP_REQUEST_TIMEOUT_MS

Official-source request timeout

15000

MCP tools in v0.1

Tool

Purpose

Effect

search_fivem_docs

Search allowlisted official Enhanced documentation with scope and citations

Read-only

get_native

Resolve an exact native name or hash without guessing missing definitions

Read-only

get_platform_capabilities

Retrieve the dated Enhanced capability baseline and required context

Read-only

get_cef_target

Report the source-backed CEF/Chromium target and its evidence scope

Read-only

audit_nui_compatibility

Check supplied NUI source against the live verified browser milestone

Read-only

validate_fxmanifest

Validate manifest entries, dependencies, runtime constraints, and deprecations

Read-only

review_resource_structure

Review a supplied resource tree against framework-neutral boundaries

Read-only

review_event_security

Detect client-trust and network-event security risks

Read-only

review_state_bag_usage

Detect replication and serialization hazards in supplied usage

Read-only

create_performance_test_plan

Produce a reproducible profiler, resmon, network, and NUI measurement plan

Read-only

source_health

Report freshness and failures for sources checked by this process

Read-only

refresh_sources

Refresh only the local source cache from allowlisted official origins

Cache write only

Analysis tools do not modify the user's repository. refresh_sources is the only tool that writes, and its write boundary is the configured cache directory.

Results use explicit states such as verified, inferred, ambiguous, conflict, stale, and not_found, with direct source URLs and scope metadata.

Architecture

flowchart LR
  Host["Codex or another MCP host"]
  Skill["Enhanced engineering skill"]
  Server["Typed MCP tools over stdio"]
  Domain["Enhanced-only domain services"]
  Index["Exact native lookup + weighted docs search"]
  Cache["Provenance-aware local cache"]
  Official["Allowlisted official sources"]
  Result["Status + scope + citations"]

  Host --> Skill
  Host --> Server --> Domain
  Domain --> Index --> Cache
  Cache <--> Official
  Domain --> Result --> Host

Exact native identifiers take precedence over full-text search. Source updates are validated before replacing the last known-good cache. Remote documents are data, never instructions.

Current v0.1 limits

  • Original GTA V natives are resolved by exact name or hash from the official client-native JSON.

  • CFX declarations are resolved by exact name and preserve their declared API set. If the declaration does not publish a hash, the MCP returns no hash instead of deriving one.

  • Official-document search covers the focused Enhanced engineering corpus listed in the source policy; it is not a general web search.

  • Static validators are heuristics. A clean result does not replace FiveM, browser, profiler, resmon, or security testing.

  • The embedded Enhanced capability baseline becomes stale after 30 days and must then be checked against current official documentation.

Read the full architecture and source policy.

Sources and licensing

Canonical inputs include:

The repository's MIT License applies only to this project's original code and documentation. It does not relicense FiveM, GTA, official documentation, native corpora, or third-party content. Because several official source repositories do not expose a repository-wide license, this project references or locally caches necessary data at runtime and does not vendor or redistribute those corpora.

Marketplace, Asset Escrow, paid, leaked, and private resources are excluded. See the Source Policy and the current Creator Platform License Agreement.

Development

npm ci
npm run format:check
npm run lint
npm run typecheck
npm test
npm run test:coverage
npm run build
npm run plugin:validate
npm run smoke:mcp

Run every check with:

npm run validate

Behavioral changes need tests for success, ambiguity, conflict, stale data, and failure paths. Performance claims need reproducible runtime evidence.

Contributing and security

License

Original project code and documentation are available under the MIT License.

Available Tools

12 tools
audit_nui_compatibilityAudit NUI compatibilityA
Read-only

Load FiveM's current CEF pin, then statically audit JavaScript, TypeScript, JSX, TSX, or CSS against that verified Chromium milestone. This is a heuristic build-time review, not a runtime browser test.

Inputs: loader (required), source (required). Returns: data, scope, status, sources, +2 more

create_performance_test_planCreate a FiveM performance test planA
Read-only

Create a reproducible measurement plan using profiler, resmon, network, or NUI evidence. It never claims a speedup without measurements.

Inputs: runtime (required), scenario (required). Returns: data, scope, status, sources, +2 more

get_cef_targetGet current FiveM CEF targetA
Read-only

Read and parse the current CEF/Chromium build pin from the official FiveM repository. Use before choosing an NUI browser target.

Inputs: no named parameters. Returns: data, scope, status, sources, +2 more

get_nativeGet an exact FiveM nativeA
Read-only

Look up an exact native name or hash in official sources. The caller must provide the execution API set; unknown identifiers return not_found.

Inputs: kind (required), apiSet (required), identifier (required). Returns: data, scope, status, sources, +2 more

get_platform_capabilitiesGet GTAV Enhanced capabilitiesA
Read-only

Return the verified GTAV Enhanced baseline and the context that must be known before writing code.

Inputs: no named parameters. Returns: data, scope, status, sources, +2 more

refresh_sourcesRefresh official source cacheA
Idempotent

Explicitly refresh the local cache from allowlisted official Cfx.re and citizenfx sources. It does not modify any FiveM project or external service.

Inputs: no named parameters. Returns: data, scope, status, sources, +2 more

review_event_securityReview FiveM event securityA
Read-only

Perform a static heuristic review of supplied code for untrusted network input, broadcasts, unstable source usage, and event-context mistakes.

Inputs: code (required), language (required). Returns: data, scope, status, sources, +2 more

review_resource_structureReview a resource structureA
Read-only

Review a supplied resource file list against the documented FiveM requirements and this project's explicit client/server/shared/NUI house standard.

Inputs: paths (required), uiRequired (required). Returns: data, scope, status, sources, +2 more

review_state_bag_usageReview State Bag usageA
Read-only

Perform a static heuristic review for nested State Bag serialization, scope-event scaling, and client replication risks.

Inputs: code (required), language (required). Returns: data, scope, status, sources, +2 more

search_fivem_docsSearch official FiveM docsA
Read-only

Search a focused corpus loaded from official Cfx.re documentation. Use for GTAV Enhanced resource, runtime, NUI, networking, security, and performance questions.

Inputs: query (required), limit. Returns: data, scope, status, sources, +2 more

source_healthReport official source healthA
Read-only

Report freshness, cache state, and errors for official sources checked by this MCP process.

Inputs: no named parameters. Returns: data, scope, status, sources, +2 more

validate_fxmanifestValidate fxmanifest.luaA
Read-only

Validate supplied fxmanifest.lua text for current Enhanced-only resource rules, compiled script outputs, NUI packaging, and deprecated or experimental fields.

Inputs: manifest (required), resourceFiles. Returns: data, scope, status, sources, +2 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes: search, native lookup, platform info, CEF pin retrieval, NUI audit, manifest validation, resource structure review, security review, state bag review, performance planning, and source health. The overlap between audit_nui_compatibility and get_cef_target is minimal since one is informational and the other performs a full audit, and review_resource_structure vs validate_fxmanifest target different artifacts.

    Naming Consistency4/5

    The majority of tool names follow a verb_noun pattern (search_fivem_docs, get_native, validate_fxmanifest, review_event_security, refresh_sources), but a few deviate, such as source_health (noun_verb) and audit_nui_compatibility (uses 'audit' instead of 'review'). Overall the pattern is mostly consistent and readable.

    Tool Count5/5

    12 tools is well within the ideal 3-15 range and each tool serves a specific part of the FiveM development workflow. The count feels appropriately scoped for a specialized MCP server covering documentation, native reference, platform capabilities, code review, security analysis, performance testing, and source cache management.

    Completeness4/5

    The tool surface covers the core workflows for a FiveM development assistant: searching docs, looking up natives, checking platform baseline, auditing NUI compatibility, validating manifests, reviewing resource structure/security/state bags, creating performance test plans, and managing source freshness. Minor gaps exist such as no direct code generation or runtime debugging, but these are outside the apparent scope.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that empowers AI coding agents to work effectively with Minecraft mod development, providing static analysis of decompiled source code and runtime interaction with a running Minecraft instance.
      31
      92 npm
      18
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      MCP server for searching, browsing, and analyzing decompiled Minecraft source code locally. Supports symbol lookup, text search, reference lookup, and lightweight RAG.
      11
      Apache 2.0
    • F
      license
      B
      quality
      D
      maintenance
      A focused MCP server for FiveM teams to scaffold resources, generate NUI templates, and perform safe file edits.
      11
      1
      -