fiveclaw-agent 1.2.1

Local MCP agent for FiveClaw — FiveM AI development tools

███████╗██╗██╗   ██╗███████╗ ██████╗██╗      █████╗ ██╗    ██╗
██╔════╝██║██║   ██║██╔════╝██╔════╝██║     ██╔══██╗██║    ██║
█████╗  ██║██║   ██║█████╗  ██║     ██║     ███████║██║ █╗ ██║
██╔══╝  ██║╚██╗ ██╔╝██╔══╝  ██║     ██║     ██╔══██║██║███╗██║
██║     ██║ ╚████╔╝ ███████╗╚██████╗███████╗██║  ██║╚███╔███╔╝
╚═╝     ╚═╝  ╚═══╝  ╚══════╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝

The local AI bridge between your FiveM server and your IDE.

Website · Setup Guide · Pricing

---

What is this?

fiveclaw-agent is a local MCP server that runs on your machine alongside your FiveM server. It gives your AI client (Claude, Cursor, Windsurf, etc.) direct access to your server's files, logs, MySQL database, and txAdmin — and connects it to the FiveClaw cloud platform for FiveM-specific AI intelligence.

Install once. Works everywhere you code.

---

Quick Install

pip install fiveclaw-agent

# With SSH deployment support
pip install fiveclaw-agent[ssh]

You'll need a FiveClaw account and an API key from your dashboard.

---

How it works

  ┌─────────────────────────────┐
  │   Your IDE / AI Client      │  Claude Code · Cursor · Windsurf
  │   (MCP-compatible)          │  Kilo Code · Gemini CLI
  └──────────┬──────────────────┘
             │  stdio / MCP protocol
             ▼
  ┌─────────────────────────────┐
  │      fiveclaw-agent         │  ← runs locally on your machine
  │                             │
  │  ├─ 📁 Resource map + search│
  │  ├─ 🗃  MySQL queries        │
  │  ├─ 🖥  txAdmin control      │
  │  ├─ 📋 Log reader           │
  │  ├─ 🚀 SSH deploy           │
  │  └─ 🧠 Persistent memory   │
  └──────────┬──────────────────┘
             │  HTTPS · your API key
             ▼
  ┌─────────────────────────────┐
  │   FiveClaw Platform         │
  │                             │
  │  ├─ fivem-mcp  (all plans)  │  6,400+ natives · ESX · QBCore · ox
  │  └─ ai-fivem-dev-mcp (Pro+) │  analysis · security · testing
  └─────────────────────────────┘

Your credentials never leave your machine. The agent only forwards tool requests to FiveClaw — it never uploads your code or files.

---

Local Tools

These run entirely on your machine. No API key needed.

Tool	What it does
📂 repomap_generate	Build a map of all resources in your server
🔍 tool_search	Search Lua/JS files across your resources
✅ tool_syntax_check	Check Lua syntax without running the server
📋 read_latest_logs	Tail FXServer, txAdmin, and resource logs
🗃 tool_mysql_query	Run queries against your FiveM MySQL database
🖥 tool_server_control	Start, stop, restart the FXServer via txAdmin or custom panel
🔌 tool_resource_control	Start/stop/restart individual resources via txAdmin or custom panel
📡 tool_server_console	Send console commands via txAdmin or custom panel
🚀 deploy_resource	SSH-deploy a resource directly to production
🧠 context_remember	Store persistent notes across AI sessions

---

Cloud Tools

Powered by FiveClaw. Requires an API key from fiveclaw.xyz.

fivem-mcp — included on all plans (even free)

FiveM intelligence. 6,400+ native functions, framework docs, best practices, live CFX docs.

📖 Native docs	Full reference for all 6,400+ FiveM/GTA natives with examples
🏗 Framework docs	ESX, QBCore, ox_lib, ox_core — guides, functions, patterns
💡 Best practices	Lua performance, sync patterns, common pitfalls
🔎 Anti-pattern guide	What not to do and why — with fixes
⚠️ Error solutions	Database of common FiveM errors with step-by-step fixes
🌐 Live CFX docs	Fetch live documentation directly from CFX

ai-fivem-dev-mcp — Pro + Enterprise

Deep code intelligence for your actual server resources.

🏥 Resource health	Validate manifests, exports, load order
🛡 Security scanner	Detect injection, auth bypass, and logic vulnerabilities
🔗 Export contracts	Validate that imports match their exported signatures
🎯 Event tracer	Trace any event from trigger to handler across resources
🧪 Test engine	Unit tests, event tests, database tests, coverage reports
📐 Pattern library	Scaffold new resources from reusable team templates
🔍 Duplicate detector	Find copy-pasted code blocks across your codebase
📦 Dependency graph	Visualize resource dependencies (Enterprise)
👥 Team patterns	Shared scaffolds across your whole team (Enterprise)

---

Supported AI Clients

Client	Config file
Claude Code	Project: .mcp.json · Global: ~/.claude.json
Cursor	Project: .cursor/mcp.json · Global: ~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Kilo Code	Project: .kilocode/mcp.json · Global: extension settings
Gemini CLI	~/.gemini/settings.json — merge mcpServers key

The interactive setup wizard at fiveclaw.xyz/dashboard/download generates your config automatically.

---

Manual Config

Add to your AI client's MCP config. Only FIVECLAW_API_KEY is required — remove any lines you don't use.

Windows users: Due to Python's pipe-buffering behaviour on Windows, use python as the command and pass -u -m fiveclaw_agent as args instead of calling the entry point directly:

{
  "mcpServers": {
    "fiveclaw": {
      "command": "python",
      "args": ["-u", "-m", "fiveclaw_agent"],
      "env": { "FIVECLAW_API_KEY": "fc_live_YOUR_API_KEY_HERE", "TRANSPORT": "stdio" }
    }
  }
}

The -u flag forces unbuffered I/O at the interpreter level, which is required for the MCP stdio transport to work correctly in a pipe.

Linux / macOS:

{
  "mcpServers": {
    "fiveclaw": {
      "command": "fiveclaw",
      "env": {
        "FIVECLAW_API_KEY":    "fc_live_YOUR_API_KEY_HERE",
        "FIVEM_PROJECT_ROOT":  "/path/to/your/fivem-server",
        "FIVEM_RESOURCES_DIR": "/path/to/your/fivem-server/resources",

        "TXADMIN_URL":         "http://localhost:40120",
        "TXADMIN_USER":        "admin",
        "TXADMIN_PASS":        "YOUR_TXADMIN_PASSWORD",

        "MYSQL_HOST":          "127.0.0.1",
        "MYSQL_USER":          "root",
        "MYSQL_PASSWORD":      "YOUR_MYSQL_PASSWORD",
        "MYSQL_DATABASE":      "fivem",
        "MYSQL_DB2_HOST":     "127.0.0.1",
        "MYSQL_DB2_USER":     "root",
        "MYSQL_DB2_PASSWORD": "YOUR_PASSWORD",
        "MYSQL_DB2_DATABASE": "your_second_db",

        "FIVEM_SSH_HOST":      "YOUR_VPS_IP",
        "FIVEM_SSH_USER":      "root",
        "FIVEM_SSH_KEY":       "~/.ssh/id_rsa"
      }
    }
  }
}

Custom Control Panel (alternative to txAdmin)

If you run a custom admin panel instead of txAdmin, replace the TXADMIN_* fields with ADMIN_PANEL_*. All four endpoints must be set explicitly, and FIVEM_LOGS_DIR is required.

{
  "mcpServers": {
    "fiveclaw": {
      "command": "fiveclaw",
      "env": {
        "FIVECLAW_API_KEY":              "fc_live_YOUR_API_KEY_HERE",
        "FIVEM_PROJECT_ROOT":            "/path/to/your/fivem-server",
        "FIVEM_RESOURCES_DIR":           "/path/to/your/fivem-server/resources",

        "ADMIN_PANEL_TYPE":              "custom",
        "ADMIN_PANEL_URL":               "http://localhost:30121",
        "ADMIN_PANEL_STATUS_ENDPOINT":   "/api/server/status",
        "ADMIN_PANEL_START_ENDPOINT":    "/api/server-control/start",
        "ADMIN_PANEL_STOP_ENDPOINT":     "/api/server-control/stop",
        "ADMIN_PANEL_COMMAND_ENDPOINT":  "/api/server-control/command",
        "FIVEM_LOGS_DIR":                "/path/to/logs",

        "MYSQL_HOST":                    "127.0.0.1",
        "MYSQL_USER":                    "root",
        "MYSQL_PASSWORD":                "YOUR_MYSQL_PASSWORD",
        "MYSQL_DATABASE":                "fivem",
        "MYSQL_DB2_HOST":                 "127.0.0.1",
        "MYSQL_DB2_USER":                 "root",
        "MYSQL_DB2_PASSWORD":             "YOUR_PASSWORD",
        "MYSQL_DB2_DATABASE":             "your_second_db",
        "MYSQL_DB3_HOST":                 "127.0.0.1",
        "MYSQL_DB3_USER":                 "root",
        "MYSQL_DB3_PASSWORD":             "YOUR_PASSWORD",
        "MYSQL_DB3_DATABASE":             "your_third_db",

        "FIVEM_SSH_HOST":                "YOUR_VPS_IP",
        "FIVEM_SSH_USER":                "root",
        "FIVEM_SSH_KEY":                 "~/.ssh/id_rsa"
      }
    }
  }
}

Note: FIVEM_LOGS_DIR is required when using ADMIN_PANEL_TYPE=custom. With txAdmin (the default), logs are auto-detected from FIVEM_PROJECT_ROOT/logs.

Restart your AI client after saving.

Verify it's working

Ask your AI: "Run mcp_health to check my FiveClaw connection."

---

Platform Support

Environment	Status
Linux (local agent + Linux FiveM server)	✅ Fully tested
macOS (local agent)	✅ Should work — untested
Windows (local agent or Windows FiveM server)	✅ Supported — use python -u -m fiveclaw_agent (see Windows config above)

Note: Windows is supported. Use python -u -m fiveclaw_agent instead of the fiveclaw entry point — this bypasses Windows pipe-buffering issues with the .exe launcher. SSH deployment and MySQL on Windows should work; open an issue if you hit edge cases.

Requirements

• Python 3.10+
• A FiveClaw account with an active subscription
• API key from fiveclaw.xyz/dashboard/keys

---

License

MIT — free to use, fork, and modify.
The fiveclaw-agent itself is open source. The cloud tools (fivem-mcp, ai-fivem-dev-mcp) are proprietary services accessed via API key.

---

Built by FiveClaw · Get started free