fiveclaw-agent 1.0.8

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

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.

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.

ai-fivem-dev-mcp — Pro + Enterprise

Deep code intelligence for your actual server resources.

Supported AI Clients

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.

{
  "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",
        "FIVEM_SSH_HOST":      "YOUR_VPS_IP",
        "FIVEM_SSH_USER":      "root",
        "FIVEM_SSH_KEY":       "~/.ssh/id_rsa"
      }
    }
  }
}

Restart your AI client after saving.

Verify it's working

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

Platform Support

Note: Development and testing has been done entirely on Linux (local machine + remote server). Windows support is being actively worked on — core functionality should work, but edge cases around SSH deployment and MySQL tooling on Windows may need ironing out. If you hit an issue on Windows, open an issue.

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