{
  "markdown": "# redm-mcp — RedM / RDR3 docs MCP server\n\nModel Context Protocol (MCP) server for **RedM** / **RDR3**: native lookups (hash ↔ name), semantic search, framework docs (**VORP**, **RSGCore**, **oxmysql**), and the `rdr3_discoveries` community data (peds, weapons, animations, AI flags, props, audio banks). Gives AI coding agents (Claude Code, Cursor, Claude Desktop, VS Code Copilot, Zed, …) exact answers instead of guesses.\n\nRuns as a hosted HTTP-transport MCP at `https://redm-mcp.fivem.no/mcp` — no local install, no auth, just point your client at it.\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_redm--mcp-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22redm-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fredm-mcp.fivem.no%2Fmcp%22%7D)\n[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_redm--mcp-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](vscode-insiders:mcp/install?%7B%22name%22%3A%22redm-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fredm-mcp.fivem.no%2Fmcp%22%7D)\n[![Add to Cursor](https://img.shields.io/badge/Cursor-Add_redm--mcp-000000?style=flat-square&logo=cursor&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=redm-mcp&config=eyJ1cmwiOiJodHRwczovL3JlZG0tbWNwLmZpdmVtLm5vL21jcCIsInR5cGUiOiJodHRwIn0=)\n\n> 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.\n\n## Why\n\nWhen an agent reads RedM code it typically encounters:\n\n```lua\nCitizen.InvokeNative(0x09C28F828EE674FA, player, 1.5, 5000)\n```\n\nWithout a lookup, the agent guesses at parameters and semantics. With this server:\n\n```\nlookup_native({ hash: \"0x09C28F828EE674FA\" })\n→ BOOST_PLAYER_HORSE_SPEED_FOR_TIME(player Player, speedBoost float, duration int)\n```\n\nThe server advertises its own usage via MCP `instructions` — no skill or extra client config needed.\n\n## Tools\n\n| Tool | Use |\n|------|-----|\n| `lookup_native` | Exact lookup by hash or name. O(1). Use for `Citizen.InvokeNative(0x...)` or `SCREAMING_SNAKE_CASE` names. |\n| `semantic_search` | Search by behavior/concept (\"teleport player\", \"spawn horse\"). |\n| `grep_docs` | Regex/literal grep across raw doc files. Required for the large `rdr3_discoveries` data tables (audio_banks, ingameanims, …) which are only preview-indexed in embeddings. |\n| `list_namespaces` | List categories and namespaces. |\n| `browse` | List document paths under a category/namespace. |\n| `get_document` | Fetch full markdown for a doc path. |\n\n## Client setup\n\nAll clients connect to `https://redm-mcp.fivem.no/mcp`. No authentication required.\n\nVS 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/`](examples/).\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http redm-mcp https://redm-mcp.fivem.no/mcp\n```\n\nOr edit `~/.claude.json` manually:\n\n```json\n{\n  \"mcpServers\": {\n    \"redm-mcp\": {\n      \"type\": \"http\",\n      \"url\": \"https://redm-mcp.fivem.no/mcp\"\n    }\n  }\n}\n```\n\n### Cursor\n\nEdit `~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project root):\n\n```json\n{\n  \"mcpServers\": {\n    \"redm-mcp\": {\n      \"url\": \"https://redm-mcp.fivem.no/mcp\"\n    }\n  }\n}\n```\n\nRestart Cursor. Check `Settings → MCP` for green status.\n\n### Claude Desktop\n\nClaude 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):\n\n```json\n{\n  \"mcpServers\": {\n    \"redm-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https://redm-mcp.fivem.no/mcp\"\n      ]\n    }\n  }\n}\n```\n\nRestart Claude Desktop.\n\n### VS Code (Copilot / Continue)\n\n`.vscode/mcp.json` in a project root:\n\n```json\n{\n  \"servers\": {\n    \"redm-mcp\": {\n      \"type\": \"http\",\n      \"url\": \"https://redm-mcp.fivem.no/mcp\"\n    }\n  }\n}\n```\n\n### Zed\n\n`~/.config/zed/settings.json`:\n\n```json\n{\n  \"context_servers\": {\n    \"redm-mcp\": {\n      \"command\": {\n        \"path\": \"npx\",\n        \"args\": [\n          \"-y\",\n          \"mcp-remote\",\n          \"https://redm-mcp.fivem.no/mcp\"\n        ]\n      }\n    }\n  }\n}\n```\n\n### Other clients (generic)\n\n- HTTP transport clients: point to `https://redm-mcp.fivem.no/mcp`\n- stdio-only clients: use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) as a proxy\n\n## Verify it works\n\n1. `curl https://redm-mcp.fivem.no/health` → `{\"ok\":true}`\n2. `curl https://redm-mcp.fivem.no/ingest-status` → shows version and last ingested timestamp\n3. In your client: ask the agent to look up `0x09C28F828EE674FA` — should return `BOOST_PLAYER_HORSE_SPEED_FOR_TIME`\n\n## Endpoints\n\n| Path | Auth | Purpose |\n|------|------|---------|\n| `POST /mcp` | no | MCP protocol |\n| `GET /health` | no | Liveness |\n| `GET /ingest-status` | no | `{ current, last, ingestedAt, upToDate }` |\n| `GET /stats` | no | Usage stats (tool counters, durations, breakdowns). Metadata only — no queries or secrets stored. |\n| `GET /dashboard` | no | HTML dashboard over `/stats`. |\n\n## Example prompts\n\nSee [`examples/prompts.md`](examples/prompts.md) for things to try once installed (native lookups, behavior searches, framework / inventory questions, debugging).\n\n## Issues / feedback\n\nBug, missing docs, incorrect native lookups, requests for new tools? [Open an issue](../../issues/new).\n\n## Doc sources\n\nIndexed upstreams:\n- [femga/rdr3_discoveries](https://github.com/femga/rdr3_discoveries) — community ped/weapon/anim/prop hashes, AI flags, enums\n",
  "bytes": 5754,
  "sha": "836c7e254412edfc16d3ef09ca433ef9891df18615c6be2a59b1c3fe82687fe5",
  "repo_slug": "cmoen11/redm-mcp-public",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_cmoen11_redm_mcp_7577a420/readme"
}