Rivo Tools

FiveM and GTA V tools: convert, merge, optimize and build resources, and make AI props and liveries.

Hosted MCP Server

npx add-mcp 'https://mcp.rivo.tools/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Rivo Tools in your AI agent.

The Rivo Tools MCP server lets Claude, ChatGPT, Cursor, VS Code and Codex use Rivo's FiveM tools. Your agent can convert mods, merge and optimize game files, and build resources.

https://mcp.rivo.tools/mcp Copy

What you need to know.

One URL works in every client. Sign in once per client.

Server URL

https://mcp.rivo.tools/mcp

Transport

Streamable HTTP

Sign-in

OAuth with your Rivo account, or a personal token

Plan

Pro or Studio

Tools

How sign-in works

When you add the server, your client opens rivo.tools so you can sign in. You then choose what that agent may do: read job status and the catalog, run tools, spend credits, and read your workspaces. You also pick which groups of tools it sees. Change or revoke any connection in Settings, Agent connections.

Credits and limits

Converting, merging, optimizing and building count toward your plan's daily tool calls. AI tools spend credits, and only on a connection you allowed to spend them. Set a monthly credit cap per connection. Failed AI jobs are refunded. The rivo_usage tool shows your calls, caps and balance.

Set it up.

Pick your client. Each one signs in with your Rivo account; the coding tools can use a token instead.

Claude.ai

Open Settings, then Connectors, and choose Add custom connector.
Name it Rivo Tools, paste the URL, then sign in with your Rivo account when asked.

https://mcp.rivo.tools/mcp

Claude Code

Run this in a terminal. Add --scope user to use Rivo in every project.
Run /mcp inside Claude Code, pick rivo and choose Authenticate. Sign in with your Rivo account in the browser.

claude mcp add --transport http rivo https://mcp.rivo.tools/mcp

Use a token instead

Create a token in Settings, Agent connections, then:

Run this in a terminal. Add --scope user to use Rivo in every project.
Run /mcp inside Claude Code to check the connection.

claude mcp add --transport http rivo https://mcp.rivo.tools/mcp --header "Authorization: Bearer <your token>"

ChatGPT

Open Settings, then Apps and Connectors, and create a custom connector. You may need to turn on developer mode under Advanced first.
Paste the URL, pick OAuth, then sign in with your Rivo account when asked.

https://mcp.rivo.tools/mcp

Cursor

Add this to ~/.cursor/mcp.json for every project, or.cursor/mcp.json for one.
Open Cursor Settings, then MCP, and click Connect next to rivo. Sign in with your Rivo account in the browser.

{
  "mcpServers": {
    "rivo": {
      "url": "https://mcp.rivo.tools/mcp"
    }
  }
}

Use a token instead

Create a token in Settings, Agent connections, then:

Add this to ~/.cursor/mcp.json for every project, or.cursor/mcp.json for one.
Keep the file out of version control, it holds your token.

{
  "mcpServers": {
    "rivo": {
      "url": "https://mcp.rivo.tools/mcp",
      "headers": {
        "Authorization": "Bearer <your token>"
      }
    }
  }
}

VS Code

Add this to.vscode/mcp.json and start the server from the file.
VS Code opens the browser so you can sign in with your Rivo account.

{
  "servers": {
    "rivo": {
      "type": "http",
      "url": "https://mcp.rivo.tools/mcp"
    }
  }
}

Use a token instead

Create a token in Settings, Agent connections, then:

Add this to.vscode/mcp.json and start the server from the file.
VS Code asks for the token once and stores it securely, so the file is safe to commit.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "rivo-token",
      "description": "Rivo Tools token",
      "password": true
    }
  ],
  "servers": {
    "rivo": {
      "type": "http",
      "url": "https://mcp.rivo.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${input:rivo-token}"
      }
    }
  }
}

Codex

Add the server, then sign in. The login command opens the browser so you can sign in with your Rivo account.

codex mcp add rivo --url https://mcp.rivo.tools/mcp
codex mcp login rivo

Use a token instead

Create a token in Settings, Agent connections, then:

Codex reads the token from the RIVO_MCP_TOKEN environment variable, so it never sits in the config file.
Set the variable, then add the server with the command or the config.toml block.

export RIVO_MCP_TOKEN="<your token>"

setx RIVO_MCP_TOKEN "<your token>"

codex mcp add rivo --url https://mcp.rivo.tools/mcp --bearer-token-env-var RIVO_MCP_TOKEN

[mcp_servers.rivo]
url = "https://mcp.rivo.tools/mcp"
bearer_token_env_var = "RIVO_MCP_TOKEN"

Every tool.

What the server lists, by group. Tools marked Asks first can delete or replace files. They are flagged as destructive, so your client can check with you before it runs them.

rivo_search_tools Find a Rivo tool Read-only Search every Rivo Tools tool this connection may use, including ones not listed here, and get each one's input schema.
rivo_run Run any Rivo tool Asks first Call a tool found with rivo_search_tools that isn't in this connection's tool list.
rivo_upload_file Upload a file Get a file into Rivo so tools can use it, and receive its file_id.
rivo_job_status Check a job Read-only Status, progress and, once finished, download links for a job started by another tool.
rivo_job_wait Wait for a job Read-only Wait up to timeout_seconds (max 25) for a job to finish, then return its status and download links.
rivo_job_cancel Cancel a job Asks first Cancel a queued or running job.
rivo_usage Limits and usage Read-only This connection's permissions, today's call usage against the plan's limits, and the credit balance.
rivo_tool_details Tool operation schemas Read-only Discover all editing, import, export and inspection operations for a tool, or retrieve the exact named argument schema for one operation.
rivo_project_read Read part of an editable project Read-only Read an owned JSON project/result, optionally selecting a JSON Pointer path and paging an array.
rivo_project Create or edit a project Create an editable JSON document or apply ordered JSON Pointer patches to an owned file.
rivo_assets Browse all asset libraries Read-only Search and browse clothing, vehicles, peds, props and animation libraries.
rivo_asset_categories Asset library categories Read-only List the asset libraries or category groups and counts for props and animations.
rivo_asset_get Read an asset Read-only Get an asset's full metadata, model and texture URLs, or all clips in an animation dictionary.
rivo_convert_resource Mod to FiveM: a GTA mod made into a FiveM resource Convert a GTA V mod (single-player files or an OpenIV package, as a zip) into a FiveM resource. Also listed as rivo_cfx_convert.
rivo_merge Merge game files Merge several files of one kind into one: ymap, ytyp, ybn (collisions), ydr, scenario (ymt) or clothing (EUP packs). Also listed as rivo_ymap_merger, rivo_ytyp_merger, rivo_ybn_merger, rivo_ydr_merger, rivo_scenario_merger, rivo_clothing_merger.
rivo_resolve_conflicts Map conflict resolver Find map conflicts between resources (overlapping ymaps, occlusion, collisions) and build one fix resource. Also listed as rivo_conflict_resolver.
rivo_xml_to_ymap Map editor XML to YMAP Convert a Menyoo or Map Editor XML export into a.ymap. Also listed as rivo_xml_ymap.
rivo_vehicle_converter Vehicle converter: analyse a car model Start converting a 3D car model (FBX, GLB or glTF) into a FiveM vehicle.
rivo_vehicle_convert Vehicle converter: build the resource Build the FiveM vehicle resource from a finished rivo_vehicle_converter analysis, using its suggested part mapping.
rivo_optimize Optimize textures, clothing, props or vehicles Shrink a.ytd (texture dictionary),.ydd (clothing),.ydr (prop) or.yft (vehicle model) so it streams faster. Also listed as rivo_optimize_textures, rivo_optimize_clothing, rivo_optimize_props, rivo_optimize_vehicles.
rivo_ymt_generator EUP clothing YMT generator Generate the clothing.ymt (and optionally shop meta) for a set of drawables, packaged as a FiveM resource zip.
rivo_tattoo_pack Tattoo pack creator Turn PNG or JPG artwork into a tattoo collection resource (overlays, shop entries, textures).
rivo_embroidery Embroidery patch Turn a logo into a stitched embroidery patch texture set.
rivo_sketchfab_search Search Sketchfab models Read-only Search downloadable Sketchfab models to turn into a prop with rivo_sketchfab_prop.
rivo_sketchfab_prop Sketchfab or GLB to FiveM prop Convert a Sketchfab model (by url) or an uploaded.glb into a streamed FiveM prop resource with collision and LODs.
rivo_animation_creator Animation Creator Pose a ped skeleton on a timeline and export a.ycd animation or a streamed animation resource.
rivo_asset_collision Asset Conflict Finder Find stream assets and spawn codes that share a name across resources and clash in game.
rivo_backdoor_scanner Malware Scanner Scan a resource's Lua and JS for backdoor patterns: dynamic code, obfuscated blobs, secret reads and exfiltration hosts.
rivo_carcols_fixer Carcols ID Fixer Find siren, light and modkit ids claimed twice across vehicle packs, renumber them and rewrite the carvariations bindings.
rivo_carcols_generator Vehicle Modkit Creator Build a vehicle modkit: carcols.meta and carvariations.meta from a part list.
rivo_chevron_generator Vehicle Chevron Creator Build emergency vehicle warning chevron panels as a print-ready PNG.
rivo_collision_modifier Collision Modifier Inspect a collision file's bounds and what each one blocks, and rebuild it with changes.
rivo_fxmanifest FXManifest Creator Scan a resource's files and write a correct fxmanifest.lua.
rivo_fxmanifest_linter FXManifest Checker Check a resource's fxmanifest against its real files: missing scripts and unexported data files.
rivo_handling_comparator Handling Comparer Compare two handling.meta files and list every changed stat.
rivo_handling_editor Handling Editor Read, tune and export handling.meta entries, with estimated top speed and acceleration.
rivo_lightme Siren Pattern Editor Design carcols.meta siren patterns and export them.
rivo_livery_designer Livery Designer Paint a livery onto a vehicle's UV map and export the texture.
rivo_livery_template Livery Template Creator Turn a vehicle.yft into a print-ready UV livery template PNG.
rivo_minimap_creator Minimap Creator Build a circle, hexagon or angled minimap resource with health, armour, stress and lung bars.
rivo_mlo_creator MLO Creator Design walls, doors, windows and props, and export a streamed MLO interior with portals, collision and audio occlusion.
rivo_oels_converter oELS Converter Convert an ELS vcf into an oELS vehicle config and pattern.
rivo_outfit_inspector Clothing Viewer Decode a clothing.ydd and its textures to geometry, textures and UV templates.
rivo_paint_booth Paint Booth Decode a vehicle model and textures, and render paint and texture changes.
rivo_particle_creator Particle Creator Change a GTA V particle effect's colors, size, texture and motion, and export it as a streamed particle dictionary.
rivo_resmon_parser Resmon Analyzer Parse a resmon dump into ranked CPU offenders and memory hogs.
rivo_resource_dependency_grapher Resource Dependency Map Map every dependency in a resources folder and report the missing ones.
rivo_retexturer Retexturer Open a.ytd, replace or paint its textures, and rebuild it.
rivo_frame Rivo Frame Render 4K product images of a vehicle model.
rivo_server_cfg Server CFG Creator Generate a clean, correctly ordered server.cfg.
rivo_siren_converter Siren Pack Creator Turn audio files into a WMServerSirens or Luxart siren pack.
rivo_spawn_list Spawn Code Finder List every spawn code per pack in a vehicle pack folder, with mod parts filtered out.
rivo_spawn_organizer Spawn Code Renamer Rename a pack's spawn codes, rewriting every meta file and renaming the stream files.
rivo_stream_auditor Server Load Checker Find oversized textures and models in a resource, with a per-resource size breakdown.
rivo_street_sign_creator Street Sign Creator Make placeable street name signs in US, UK or EU style and rename the streets on the HUD to match.
rivo_stripe_generator Vehicle Stripe Creator Build bodyside, racing and accent stripes as a print-ready PNG or SVG.
rivo_tattoo_creator Tattoo Creator Design a tattoo pack and export it as a FiveM resource.
rivo_texture_replacer Texture Replacer Replace any texture a model uses, embedded or in its.ytd.
rivo_vehicle_audio Engine Sound Creator Build a custom engine sound pack (dat151, dat54 and AWC) as a drop-in resource.
rivo_vehicle_debadger Badge Remover Remove badges and emblems from a vehicle model and export a clean.yft.
rivo_vehicle_meta_validator Vehicle Meta Checker Check vehicles, handling, carvariations and carcols meta for the bugs that stop a car spawning.
rivo_vinewood_sign Vinewood Sign Creator Export a resource that replaces the Vinewood sign with a server's name, font, colors and night lighting.
rivo_weapon_editor Weapon Editor Edit weapon meta: damage, recoil, fire rate and ammo.
rivo_weapon_icon_generator Icon Generator Render inventory icons for items and weapons from a 3D model or game prop, for ox_inventory and qb-inventory.
rivo_weapon_inspector Weapon Viewer Decode a weapon.ydr and its textures to geometry, textures and UV templates.
rivo_zels_converter zELS Converter Convert an ELS vcf into a Z_ELS vehicle config.lua.
rivo_asset_animation Read editable animation tracks Load a catalogue animation clip's tracks for inspection and editing in Animation Creator.
rivo_asset_prop_model Download a prop model Convert a catalogue prop to GLB, returning a downloadable, reusable owned file_id.
rivo_livery_generate AI livery Credits Generate a vehicle livery with AI onto the vehicle's UV template. Also listed as rivo_livery_generator.
rivo_prop_generate AI image to 3D prop Credits Turn an image of an object into a textured 3D FiveM prop. Also listed as rivo_prop_generator.
rivo_prop_source_image AI prop reference image Credits Generate a clean product-style image of a described object, ready to feed rivo_prop_generate.
rivo_ws_list List workspaces Read-only Your Rivo workspaces (synced FiveM servers and file sets) with their ids.
rivo_ws_tree List a workspace folder Read-only Entries of one folder in a workspace.
rivo_ws_read Read a workspace file Read-only Read a text file from a workspace (up to 256 KB).
rivo_ws_search Search a workspace Read-only Find files in a workspace by name or path text, optionally within a folder or by extension.
rivo_ws_diff Diff two snapshots Read-only What changed between two snapshots of a workspace: added, removed and modified files grouped by resource.
rivo_ws_health Workspace health findings Read-only Problems Rivo found in a workspace: backdoors and malware patterns, broken manifests, missing dependencies, oversized assets.

Questions.

What is the Rivo Tools MCP server?

A hosted Model Context Protocol server at https://mcp.rivo.tools/mcp. It gives an AI agent the Rivo FiveM tools: converting mods, merging and optimizing game files, building resources, AI liveries and props, and read-only access to your synced server workspaces.

Which plan do I need?

A Pro or Studio plan. Each plan has a daily tool call allowance and a limit on connected agents. The rivo_usage tool shows your calls, caps and credit balance.

Does it cost credits?

Converting, merging, optimizing and building count toward your daily calls, not credits. AI tools spend credits, and only when the connection was allowed to spend them. Failed AI jobs are refunded.

Can the agent change or delete my files?

Workspace access is read-only. Tools that delete, replace or stop something are marked destructive, so your client asks before it calls them.