Skip to content

MCP server

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

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
Tools
92

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

  1. Open Settings, then Connectors, and choose Add custom connector.
  2. Name it Rivo Tools, paste the URL, then sign in with your Rivo account when asked.
Server URL
https://mcp.rivo.tools/mcp

Claude Code

  1. Run this in a terminal. Add --scope user to use Rivo in every project.
  2. Run /mcp inside Claude Code, pick rivo and choose Authenticate. Sign in with your Rivo account in the browser.
Terminal
claude mcp add --transport http rivo https://mcp.rivo.tools/mcp
Use a token instead

Create a token in Settings, Agent connections, then:

  1. Run this in a terminal. Add --scope user to use Rivo in every project.
  2. Run /mcp inside Claude Code to check the connection.
Terminal
claude mcp add --transport http rivo https://mcp.rivo.tools/mcp --header "Authorization: Bearer <your token>"

ChatGPT

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

Cursor

  1. Add this to ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
  2. Open Cursor Settings, then MCP, and click Connect next to rivo. Sign in with your Rivo account in the browser.
mcp.json
{
  "mcpServers": {
    "rivo": {
      "url": "https://mcp.rivo.tools/mcp"
    }
  }
}
Use a token instead

Create a token in Settings, Agent connections, then:

  1. Add this to ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
  2. Keep the file out of version control, it holds your token.
mcp.json
{
  "mcpServers": {
    "rivo": {
      "url": "https://mcp.rivo.tools/mcp",
      "headers": {
        "Authorization": "Bearer <your token>"
      }
    }
  }
}

VS Code

  1. Add this to .vscode/mcp.json and start the server from the file.
  2. VS Code opens the browser so you can sign in with your Rivo account.
.vscode/mcp.json
{
  "servers": {
    "rivo": {
      "type": "http",
      "url": "https://mcp.rivo.tools/mcp"
    }
  }
}
Use a token instead

Create a token in Settings, Agent connections, then:

  1. Add this to .vscode/mcp.json and start the server from the file.
  2. VS Code asks for the token once and stores it securely, so the file is safe to commit.
.vscode/mcp.json
{
  "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

  1. Add the server, then sign in. The login command opens the browser so you can sign in with your Rivo account.
Terminal
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:

  1. Codex reads the token from the RIVO_MCP_TOKEN environment variable, so it never sits in the config file.
  2. Set the variable, then add the server with the command or the config.toml block.
Environment variable (macOS and Linux)
export RIVO_MCP_TOKEN="<your token>"
Environment variable (Windows PowerShell)
setx RIVO_MCP_TOKEN "<your token>"
Terminal
codex mcp add rivo --url https://mcp.rivo.tools/mcp --bearer-token-env-var RIVO_MCP_TOKEN
Or ~/.codex/config.toml
[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.

Core

Files, jobs, search, usage, projects and the asset libraries.

  • rivo_search_toolsFind a Rivo toolRead-only

    Search every Rivo Tools tool this connection may use, including ones not listed here, and get each one's input schema.

  • rivo_runRun any Rivo toolAsks first

    Call a tool found with rivo_search_tools that isn't in this connection's tool list.

  • rivo_upload_fileUpload a file

    Get a file into Rivo so tools can use it, and receive its file_id.

  • rivo_job_statusCheck a jobRead-only

    Status, progress and, once finished, download links for a job started by another tool.

  • rivo_job_waitWait for a jobRead-only

    Wait up to timeout_seconds (max 25) for a job to finish, then return its status and download links.

  • rivo_job_cancelCancel a jobAsks first

    Cancel a queued or running job.

  • rivo_usageLimits and usageRead-only

    This connection's permissions, today's call usage against the plan's limits, and the credit balance.

  • rivo_tool_detailsTool operation schemasRead-only

    Discover all editing, import, export and inspection operations for a tool, or retrieve the exact named argument schema for one operation.

  • rivo_project_readRead part of an editable projectRead-only

    Read an owned JSON project/result, optionally selecting a JSON Pointer path and paging an array.

  • rivo_projectCreate or edit a project

    Create an editable JSON document or apply ordered JSON Pointer patches to an owned file.

  • rivo_assetsBrowse all asset librariesRead-only

    Search and browse clothing, vehicles, peds, props and animation libraries.

  • rivo_asset_categoriesAsset library categoriesRead-only

    List the asset libraries or category groups and counts for props and animations.

  • rivo_asset_getRead an assetRead-only

    Get an asset's full metadata, model and texture URLs, or all clips in an animation dictionary.

Convert

Mod to FiveM, mergers, conflict resolver, XML to YMAP.

  • rivo_convert_resourceMod 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_mergeMerge 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_conflictsMap 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_ymapMap editor XML to YMAP

    Convert a Menyoo or Map Editor XML export into a .ymap.

    Also listed as rivo_xml_ymap.

  • rivo_vehicle_converterVehicle converter: analyse a car model

    Start converting a 3D car model (FBX, GLB or glTF) into a FiveM vehicle.

  • rivo_vehicle_convertVehicle converter: build the resource

    Build the FiveM vehicle resource from a finished rivo_vehicle_converter analysis, using its suggested part mapping.

Optimize

Texture, clothing and prop optimizers.

  • rivo_optimizeOptimize 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.

Build

YMT, tattoo packs, Sketchfab props, and the website editors (MLO, handling, sirens, liveries).

  • rivo_ymt_generatorEUP clothing YMT generator

    Generate the clothing .ymt (and optionally shop meta) for a set of drawables, packaged as a FiveM resource zip.

  • rivo_tattoo_packTattoo pack creator

    Turn PNG or JPG artwork into a tattoo collection resource (overlays, shop entries, textures).

  • rivo_embroideryEmbroidery patch

    Turn a logo into a stitched embroidery patch texture set.

  • rivo_sketchfab_searchSearch Sketchfab modelsRead-only

    Search downloadable Sketchfab models to turn into a prop with rivo_sketchfab_prop.

  • rivo_sketchfab_propSketchfab 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_creatorAnimation Creator

    Pose a ped skeleton on a timeline and export a .ycd animation or a streamed animation resource.

  • rivo_asset_collisionAsset Conflict Finder

    Find stream assets and spawn codes that share a name across resources and clash in game.

  • rivo_backdoor_scannerMalware Scanner

    Scan a resource's Lua and JS for backdoor patterns: dynamic code, obfuscated blobs, secret reads and exfiltration hosts.

  • rivo_carcols_fixerCarcols ID Fixer

    Find siren, light and modkit ids claimed twice across vehicle packs, renumber them and rewrite the carvariations bindings.

  • rivo_carcols_generatorVehicle Modkit Creator

    Build a vehicle modkit: carcols.meta and carvariations.meta from a part list.

  • rivo_chevron_generatorVehicle Chevron Creator

    Build emergency vehicle warning chevron panels as a print-ready PNG.

  • rivo_collision_modifierCollision Modifier

    Inspect a collision file's bounds and what each one blocks, and rebuild it with changes.

  • rivo_fxmanifestFXManifest Creator

    Scan a resource's files and write a correct fxmanifest.lua.

  • rivo_fxmanifest_linterFXManifest Checker

    Check a resource's fxmanifest against its real files: missing scripts and unexported data files.

  • rivo_handling_comparatorHandling Comparer

    Compare two handling.meta files and list every changed stat.

  • rivo_handling_editorHandling Editor

    Read, tune and export handling.meta entries, with estimated top speed and acceleration.

  • rivo_lightmeSiren Pattern Editor

    Design carcols.meta siren patterns and export them.

  • rivo_livery_designerLivery Designer

    Paint a livery onto a vehicle's UV map and export the texture.

  • rivo_livery_templateLivery Template Creator

    Turn a vehicle .yft into a print-ready UV livery template PNG.

  • rivo_minimap_creatorMinimap Creator

    Build a circle, hexagon or angled minimap resource with health, armour, stress and lung bars.

  • rivo_mlo_creatorMLO Creator

    Design walls, doors, windows and props, and export a streamed MLO interior with portals, collision and audio occlusion.

  • rivo_oels_converteroELS Converter

    Convert an ELS vcf into an oELS vehicle config and pattern.

  • rivo_outfit_inspectorClothing Viewer

    Decode a clothing .ydd and its textures to geometry, textures and UV templates.

  • rivo_paint_boothPaint Booth

    Decode a vehicle model and textures, and render paint and texture changes.

  • rivo_particle_creatorParticle Creator

    Change a GTA V particle effect's colors, size, texture and motion, and export it as a streamed particle dictionary.

  • rivo_resmon_parserResmon Analyzer

    Parse a resmon dump into ranked CPU offenders and memory hogs.

  • rivo_resource_dependency_grapherResource Dependency Map

    Map every dependency in a resources folder and report the missing ones.

  • rivo_retexturerRetexturer

    Open a .ytd, replace or paint its textures, and rebuild it.

  • rivo_frameRivo Frame

    Render 4K product images of a vehicle model.

  • rivo_server_cfgServer CFG Creator

    Generate a clean, correctly ordered server.cfg.

  • rivo_siren_converterSiren Pack Creator

    Turn audio files into a WMServerSirens or Luxart siren pack.

  • rivo_spawn_listSpawn Code Finder

    List every spawn code per pack in a vehicle pack folder, with mod parts filtered out.

  • rivo_spawn_organizerSpawn Code Renamer

    Rename a pack's spawn codes, rewriting every meta file and renaming the stream files.

  • rivo_stream_auditorServer Load Checker

    Find oversized textures and models in a resource, with a per-resource size breakdown.

  • rivo_street_sign_creatorStreet Sign Creator

    Make placeable street name signs in US, UK or EU style and rename the streets on the HUD to match.

  • rivo_stripe_generatorVehicle Stripe Creator

    Build bodyside, racing and accent stripes as a print-ready PNG or SVG.

  • rivo_tattoo_creatorTattoo Creator

    Design a tattoo pack and export it as a FiveM resource.

  • rivo_texture_replacerTexture Replacer

    Replace any texture a model uses, embedded or in its .ytd.

  • rivo_vehicle_audioEngine Sound Creator

    Build a custom engine sound pack (dat151, dat54 and AWC) as a drop-in resource.

  • rivo_vehicle_debadgerBadge Remover

    Remove badges and emblems from a vehicle model and export a clean .yft.

  • rivo_vehicle_meta_validatorVehicle Meta Checker

    Check vehicles, handling, carvariations and carcols meta for the bugs that stop a car spawning.

  • rivo_vinewood_signVinewood Sign Creator

    Export a resource that replaces the Vinewood sign with a server's name, font, colors and night lighting.

  • rivo_weapon_editorWeapon Editor

    Edit weapon meta: damage, recoil, fire rate and ammo.

  • rivo_weapon_icon_generatorIcon Generator

    Render inventory icons for items and weapons from a 3D model or game prop, for ox_inventory and qb-inventory.

  • rivo_weapon_inspectorWeapon Viewer

    Decode a weapon .ydr and its textures to geometry, textures and UV templates.

  • rivo_zels_converterzELS Converter

    Convert an ELS vcf into a Z_ELS vehicle config .lua.

  • rivo_asset_animationRead editable animation tracks

    Load a catalogue animation clip's tracks for inspection and editing in Animation Creator.

  • rivo_asset_prop_modelDownload a prop model

    Convert a catalogue prop to GLB, returning a downloadable, reusable owned file_id.

AI

AI livery and prop generation, uses credits.

  • rivo_livery_generateAI liveryCredits

    Generate a vehicle livery with AI onto the vehicle's UV template.

    Also listed as rivo_livery_generator.

  • rivo_prop_generateAI image to 3D propCredits

    Turn an image of an object into a textured 3D FiveM prop.

    Also listed as rivo_prop_generator.

  • rivo_prop_source_imageAI prop reference imageCredits

    Generate a clean product-style image of a described object, ready to feed rivo_prop_generate.

Workspaces

Browse, search and diff your workspaces.

  • rivo_ws_listList workspacesRead-only

    Your Rivo workspaces (synced FiveM servers and file sets) with their ids.

  • rivo_ws_treeList a workspace folderRead-only

    Entries of one folder in a workspace.

  • rivo_ws_readRead a workspace fileRead-only

    Read a text file from a workspace (up to 256 KB).

  • rivo_ws_searchSearch a workspaceRead-only

    Find files in a workspace by name or path text, optionally within a folder or by extension.

  • rivo_ws_diffDiff two snapshotsRead-only

    What changed between two snapshots of a workspace: added, removed and modified files grouped by resource.

  • rivo_ws_healthWorkspace health findingsRead-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.

Connect your first agent.

Agent connectionsRead the docs