{"id":50748496,"url":"https://github.com/cmoen11/redm-mcp-public","last_synced_at":"2026-06-10T23:02:14.838Z","repository":{"id":355274300,"uuid":"1227460946","full_name":"Cmoen11/redm-mcp-public","owner":"Cmoen11","description":"MCP server for RedM / RDR3: native lookups (hash ↔ name), semantic search, VORP, RSGCore, oxmysql, rdr3_discoveries community data. Hosted HTTP endpoint, no auth.","archived":false,"fork":false,"pushed_at":"2026-05-02T18:36:42.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-02T20:11:28.229Z","etag":null,"topics":["ai-tools","cfx","claude","claude-code","cursor","game-dev-tools","llm-tools","lua","mcp","mcp-server","model-context-protocol","modelcontextprotocol","oxmysql","rdr2","rdr2-modding","rdr3","redm","rsgcore","vorp","vscode"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cmoen11.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-02T18:03:36.000Z","updated_at":"2026-05-02T18:36:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Cmoen11/redm-mcp-public","commit_stats":null,"previous_names":["cmoen11/redm-mcp-public"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Cmoen11/redm-mcp-public","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cmoen11%2Fredm-mcp-public","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cmoen11%2Fredm-mcp-public/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cmoen11%2Fredm-mcp-public/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cmoen11%2Fredm-mcp-public/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cmoen11","download_url":"https://codeload.github.com/Cmoen11/redm-mcp-public/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cmoen11%2Fredm-mcp-public/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34174148,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","cfx","claude","claude-code","cursor","game-dev-tools","llm-tools","lua","mcp","mcp-server","model-context-protocol","modelcontextprotocol","oxmysql","rdr2","rdr2-modding","rdr3","redm","rsgcore","vorp","vscode"],"created_at":"2026-06-10T23:02:13.330Z","updated_at":"2026-06-10T23:02:14.833Z","avatar_url":"https://github.com/Cmoen11.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# 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\u0026logo=visualstudiocode\u0026logoColor=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\u0026logo=visualstudiocode\u0026logoColor=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\u0026logo=cursor\u0026logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=redm-mcp\u0026config=eyJ1cmwiOiJodHRwczovL3JlZG0tbWNwLmZpdmVtLm5vL21jcCIsInR5cGUiOiJodHRwIn0=)\n\n\u003e 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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmoen11%2Fredm-mcp-public","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmoen11%2Fredm-mcp-public","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmoen11%2Fredm-mcp-public/lists"}