FiveM Enhanced MCP
Provides tools for FiveM development, including exact native lookups, official documentation search, platform capability baselines, CEF/NUI compatibility auditing, fxmanifest validation, resource structure reviews, event and State Bag security reviews, and performance test planning.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FiveM Enhanced MCP Check whether GET_PLAYER_PED is client-scoped and cite the source."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
FiveM Enhanced MCP
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.
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 startThe 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-enhancedAlternatively, 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 listRestart 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:localOr use the checked-in Compose definition:
docker compose run --rm fivem-enhanced-mcpUse 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_enhancedReview 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 |
| Local normalized source cache | Platform cache directory |
| Official-source request timeout |
|
MCP tools in v0.1
Tool | Purpose | Effect |
| Search allowlisted official Enhanced documentation with scope and citations | Read-only |
| Resolve an exact native name or hash without guessing missing definitions | Read-only |
| Retrieve the dated Enhanced capability baseline and required context | Read-only |
| Report the source-backed CEF/Chromium target and its evidence scope | Read-only |
| Check supplied NUI source against the live verified browser milestone | Read-only |
| Validate manifest entries, dependencies, runtime constraints, and deprecations | Read-only |
| Review a supplied resource tree against framework-neutral boundaries | Read-only |
| Detect client-trust and network-event security risks | Read-only |
| Detect replication and serialization hazards in supplied usage | Read-only |
| Produce a reproducible profiler, resmon, network, and NUI measurement plan | Read-only |
| Report freshness and failures for sources checked by this process | Read-only |
| 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 --> HostExact 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
staleafter 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:mcpRun every check with:
npm run validateBehavioral changes need tests for success, ambiguity, conflict, stale data, and failure paths. Performance claims need reproducible runtime evidence.
Contributing and security
Read CONTRIBUTING.md before opening a pull request.
Report vulnerabilities privately according to SECURITY.md.
Review notable changes in CHANGELOG.md.
Use GitHub Issues for non-sensitive defects and proposals.
License
Original project code and documentation are available under the MIT License.
Available Tools
12 toolsaudit_nui_compatibilityAudit NUI compatibilityARead-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 planARead-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 targetARead-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 nativeARead-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 capabilitiesARead-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 cacheAIdempotent
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 securityARead-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 structureARead-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 usageARead-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 docsARead-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 healthARead-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.luaARead-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
Scored across 12 tools
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.
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.
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.
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
MCP server for developer documentation, generated by doc2mcp.
MCP server for developers documentation, generated by doc2mcp.
MCP server for dev documentation, generated by doc2mcp.
MCP server for doc2mcp documentation, generated by doc2mcp.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides comprehensive access to MCP documentation through structured guides, full-text search, and interactive development workflows for building servers and clients.347 npmMIT
- AlicenseAqualityCmaintenanceAn 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.3192 npm18MIT
- AlicenseBqualityCmaintenanceMCP server for searching, browsing, and analyzing decompiled Minecraft source code locally. Supports symbol lookup, text search, reference lookup, and lightweight RAG.11Apache 2.0
- FlicenseBqualityDmaintenanceA focused MCP server for FiveM teams to scaffold resources, generate NUI templates, and perform safe file edits.111-