redm-mcp — RedM / RDR3 docs MCP server

Model Context Protocol (MCP) server for RedM / RDR3: native lookups (hash ↔ name), hybrid semantic search, static checking of agent-written scripts, framework docs (VORP, RSGCore, ox_lib, oxmysql, Feather), Cfx runtime docs, community-verified findings, map/location lookups, game-asset and discovery catalogs (peds, weapons, animations, AI flags, props, audio banks, catalog items) and an animation converter. Gives AI coding agents (Claude Code, Cursor, Claude Desktop, VS Code Copilot, Zed, …) exact answers instead of guesses.

Runs as a hosted HTTP-transport MCP at https://redm-mcp.fivem.no/mcp — no local install. Free to use; you sign in once with Discord (OAuth) when your client connects.

This repository contains only installation/usage docs and serves as the issue tracker. The server source code is proprietary and not distributed. The hosted endpoint is free to use.

Why

When an agent reads RedM code it typically encounters:

Citizen.InvokeNative(0x09C28F828EE674FA, player, 1.5, 5000)

Without a lookup, the agent guesses at parameters and semantics. With this server:

lookup_native({ hash: "0x09C28F828EE674FA" })
→ BOOST_PLAYER_HORSE_SPEED_FOR_TIME(player Player, speedBoost float, duration int)

The server advertises its own usage via MCP instructions — no skill or extra client config needed.

Related MCP server: SJ RedM MCP Server

Tools

The server also exposes MCP prompts and resources (decision tree, invoke guides, pool-size limits).

Client setup

All clients connect to https://redm-mcp.fivem.no/mcp. The first connection opens a Discord sign-in (OAuth; only your Discord identity is requested, identify scope). Clients with built-in OAuth support (Claude Code, Cursor, VS Code, Claude Desktop connectors) handle this automatically; mcp-remote does the same for stdio-only clients.

VS Code and Cursor users: click an install badge above for one-click setup. For everything else, copy-paste the config below — also available as ready-made files in examples/.

Claude Code

claude mcp add --transport http redm-mcp https://redm-mcp.fivem.no/mcp

Or edit ~/.claude.json manually:

{
  "mcpServers": {
    "redm-mcp": {
      "type": "http",
      "url": "https://redm-mcp.fivem.no/mcp"
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json (or .cursor/mcp.json in a project root):

{
  "mcpServers": {
    "redm-mcp": {
      "url": "https://redm-mcp.fivem.no/mcp"
    }
  }
}

Restart Cursor. Check Settings → MCP for green status.

Claude Desktop

Claude Desktop doesn't support HTTP MCP directly — use mcp-remote as a proxy. Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "redm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://redm-mcp.fivem.no/mcp"
      ]
    }
  }
}

Restart Claude Desktop.

VS Code (Copilot / Continue)

.vscode/mcp.json in a project root:

{
  "servers": {
    "redm-mcp": {
      "type": "http",
      "url": "https://redm-mcp.fivem.no/mcp"
    }
  }
}

Zed

~/.config/zed/settings.json:

{
  "context_servers": {
    "redm-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://redm-mcp.fivem.no/mcp"
        ]
      }
    }
  }
}

Other clients (generic)

• HTTP transport clients: point to https://redm-mcp.fivem.no/mcp

• stdio-only clients: use mcp-remote as a proxy

Verify it works

1. curl https://redm-mcp.fivem.no/health → {"ok":true}

2. curl https://redm-mcp.fivem.no/ingest-status → shows version and last ingested timestamp

3. In your client: sign in with Discord when prompted, then ask the agent to look up 0x09C28F828EE674FA — should return BOOST_PLAYER_HORSE_SPEED_FOR_TIME

Endpoints

Usage is logged per tool call (tool, arguments, Discord identity) to operate and improve the service. Scripts sent to check_code are stored with secrets masked for 90 days.

Example prompts

See examples/prompts.md for things to try once installed (native lookups, behavior searches, framework / inventory questions, debugging).

Issues / feedback

Bug, missing docs, incorrect native lookups, requests for new tools? Open an issue.

Doc sources

Indexed upstreams:

• femga/rdr3_discoveries — community ped/weapon/anim/prop hashes, AI flags, enums

• VORPCORE/documentation, rsgcore.com, overextended (ox_lib, oxmysql), Feather and community repos — framework and library docs

• VORPCORE/RDR3natives and the Cfx native dumps — natives

• citizenfx/fivem-docs — Cfx runtime/scripting docs

• jeanropke/RDOMap — map locations

• Community findings shared through share_finding