fiveclaw-agent

FiveClaw

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

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

Linux supported Windows supported Python 3.10+ License: MIT

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 Code, Cursor, Windsurf, etc.) direct access to your server's files, logs, MySQL database, SSH, 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

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

Configuration

The easiest way to get your MCP config is the interactive setup wizard at:

👉 fiveclaw.xyz/dashboard/download

It generates the exact JSON for your AI client (Claude Code, Cursor, Windsurf, Kilo Code, Gemini CLI) based on your OS, server details, and plan — including Windows-specific settings, SSH, MySQL, txAdmin, and custom panel options.

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        │
  │  ├─ 🖥  Server control       │
  │  ├─ 📋 Log reader           │
  │  ├─ 🔑 SSH tools            │
  │  ├─ 🚀 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.

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 (embedded LuaJIT — no external binary needed)
📋 `read_latest_logs`	Tail FXServer 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
📡 `tool_server_console`	Send console commands
🔑 `tool_ssh_run/ls/read/write`	Full SSH access to your remote server
🚀 `deploy_resource`	Deploy a resource directly to production
🧠 `context_remember`	Store persistent notes across AI sessions
ℹ️ `tool_platform_info`	Show configured OS, paths, and enabled services

Cloud Tools

fivem-mcp — included on all plans


📖 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
⚠️ 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


🏥 Resource health	Validate manifests, exports, load order
🛡 Security scanner	Detect injection, auth bypass, and logic vulnerabilities
🎯 Event tracer	Trace any event from trigger to handler across resources
📐 Pattern library	Scaffold new resources from reusable team templates
🔍 Duplicate detector	Find copy-pasted code across your codebase
📋 Load order validator	Catch server.cfg load order mistakes before they crash your server
🗺 Dependency graph	Map every resource dependency across your entire server

ai-fivem-dev-mcp — Enterprise


🧪 Test engine	Run full test suites (`test_resource`, `test_database`)
🎯 Event testing	Simulate and assert on live network events (`test_event`)
🔬 Function testing	Unit-test any Lua or JS function in isolation (`test_function`)
📊 Coverage reports	See exactly which functions and events are tested (`test_coverage`)
⚙️ Test generation	Auto-generate test stubs from your existing code (`test_generate`)
🧠 Shared team context	Team knowledge base stored on FiveClaw infrastructure — all members read and write

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

Platform Support

Environment	Status
Linux	✅ Fully supported
macOS	✅ Fully supported
Windows	✅ Fully supported

Windows note: Use python -u -m fiveclaw_agent as the command (not the fiveclaw entry point) to avoid pipe-buffering issues. The setup wizard handles this automatically.

Requirements

Python 3.10+
A FiveClaw account with an API key

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 the setup guide

Metadata

Release files for fiveclaw-agent 1.3.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fiveclaw-agent 1.3.5
File	Size	Uploaded
fiveclaw_agent-1.3.5.tar.gz	33.5 kB	Jul 12, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for fiveclaw-agent 1.3.5
File	Interpreter	ABI	Platform	Reset
fiveclaw_agent-1.3.5-py3-none-any.whl 33.0 kB Jul 12, 2026	Python 3	none	any	Details

Total release size: 66.5 kB

Release files / fiveclaw_agent-1.3.5.tar.gz

Download URL	fiveclaw_agent-1.3.5.tar.gz
Size	33.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`2dbeecdd00ba84ffe5577ccbc6b1260b5fefe12f0a3a0f3fb486a4f95b3eefce`
BLAKE2b-256 checksum How to use checksums	`94d3bcc229fb4184509af4d08243bf3341a85824ee1ba0dc8ced7cd45402ae89`
Upload date	Jul 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.5`

Release files / fiveclaw_agent-1.3.5-py3-none-any.whl

Download URL	fiveclaw_agent-1.3.5-py3-none-any.whl
Size	33.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9852aa5b752ec589f37c34116e7f309662c031d7dfb8b818a46a883d98eba0d9`
BLAKE2b-256 checksum How to use checksums	`b03744a56fe3a869ec09670accdfb5852b65acc62275d33b9136f9e46f51c020`
Upload date	Jul 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.5`