gta_mcp
This MCP server is a comprehensive GTA Online money-making assistant with 26 tools covering live game data, strategies, business tracking, interactive maps, and session planning.
β±οΈ Time & Live Data
Countdowns to daily (06:00 UTC) and weekly (Thursday 07:00 UTC) resets
Current weekly bonuses (2x/3x events, podium vehicle, discounts) from Rockstar Newswire
Per-platform tunables update status and daily collectible income tables
Browse/search r/gtaonline top threads and pinned megathreads
π° Money Methods & Reference
Ranked money-making methods by $/hr, filterable by category, solo-friendliness, and buy-in
Full playbooks for specific methods (Cayo Perico, Casino Heist, Agency, etc.)
Cayo Perico loot values (normal & hard mode), collectible locations/rewards, and an optimal ~$300k/day daily checklist
π’ Business Operations
Track owned businesses' stock levels, resupply/sell times, and production status
View per-business economics including sell values, capacity, and high-demand bonuses
π Properties & Calculators
Browse property catalogs with buy priorities and detailed info
Calculate sell values with public lobby bonuses/weekly multipliers and estimate property payback time
πΊοΈ Interactive Map
Access 110+ GTALens map categories (street dealers, exotic exports, gun van, collectibles, etc.)
View live locations/prices and capture map screenshots
Find today's street dealers, exotic export targets, gun van location, and freemode drug vehicle spot
πΌοΈ Offline Map Renderer
Render custom map images with markers from bundled coordinate sets or specific game-world coordinates β no browser needed
π Session Planner
Generate ranked, time-boxed action plans for any session length and goal (max-cash, fast-cash, collectibles, or balanced), weighted by weekly bonuses, business state, and reset urgency
Provides tools to fetch current top/hot threads and search r/gtaonline for community insights on GTA Online methods and topics.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gta_mcp What are this week's GTA Online bonuses?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GTA Online Money Copilot β MCP server + expert skill
A two-part GTA Online money-making assistant:
gta-online-expertskill β durable, curated expert knowledge (money playbooks, business operations, heists, combat, optimization loops, the mansion, beginner roadmap). Auto-loads when you ask Claude anything about GTA Online. Lives ingta-online-expert/.gta_mcpMCP server β 26 live/computational tools: weekly bonuses, reset timers, business operations tracking, money calculators, the full interactive map (street dealers, exotic exports, gun van, collectibles, β¦), and a session planner that mixes tactics so no time is wasted.
Tools (26)
Live / time-sensitive
gta-reset-timesβ countdown to daily (06:00 UTC) and weekly (Thu 07:00 UTC) resets.gta-weekly-bonusesβ this week's 2x/3x event, podium, discounts (Newswire, best-effort).gta-tunables-statusβ per-platform tunables update timestamps (gtaweb, needs browser).gta-daily-collectiblesβ today's daily collectible income table + live tunables freshness.gta-community-pulseβ what r/gtaonline is talking about now: top/hot threads + pinned megathreads (community sentiment, not authoritative for the multiplier).gta-community-searchβ search r/gtaonline for community takes on a specific method/business/topic.
Money methods & reference
gta-best-methodsβ rank methods by $/hr (filter category/solo/buy-in).gta-method-detailβ full playbook for one method.gta-cayo-targetsβ Cayo primary/secondary loot values.gta-collectible-locations/gta-collectible-setsβ collectible maps + one-time set rewards.gta-daily-checklistβ the optimal ~$300k/day daily routine.
Business operations (persistent state)
gta-business-set-stateβ record owned businesses + resupply/sell times (persists todata/state.json).gta-business-statusβ stock %, time-to-full, sell readiness, solo-limit warnings.gta-business-economicsβ current per-business production economics (gtaweb toolkit snapshot).
Properties & calculators
gta-properties/gta-property-detailβ property catalog + buy priority.gta-mansion-infoβ the Mansion (Prix Luxury) deep dive.gta-sell-calculatorβ sell value with high-demand bonus + weekly multiplier.gta-payback-calculatorβ how long a property takes to pay for itself.
The interactive map
gta-map-categoriesβ browse/search all 110 GTALens map categories.gta-map-locationsβ map link + live location/price panel for any category.gta-map-screenshotβ capture the live map for any category, returned inline as an image (browser).gta-street-dealers/gta-exotic-exports/gta-gun-van/gta-drug-vehicleβ today's high-value daily spots (map + data).
Offline map renderer (no browser)
gta-render-mapβ draw markers on the bundled base map from a coordinate set or custom game-world coordinates; returns the image inline. Pure Node + canvas, zero browser/network.gta-render-categoriesβ list bundled coordinate sets.
The planner (flagship)
gta-money-planβ given session length + goal, a ranked, time-boxed action list mixing passive income with active earners, weighted by this week's bonuses and reset urgency.
Related MCP server: TradingView MCP
Setup
npm install
npm run build
npm start # stdio server
npm run smoke # build + exercise the tools
npm run dev:inspect # MCP Inspector UIRegister in Claude Desktop / Cursor (mcpServers):
{
"mcpServers": {
"gta": {
"command": "node",
"args": ["./build/server.js"],
"env": { "BROWSE_FALLBACK": "1" }
}
}
}Data sources & the browser dependency
Offline (no network/browser): methods, businesses, properties, calculators, collectible rewards, the planner, map category catalog, and the economy data (bundled snapshot of gtaweb's
TOOLKIT_DATA). These always work.Browser-assisted (the
browseCLI + local Chrome):gta-map-screenshotand the live map/data tools open gtalens/gtaweb. The community tools (gta-community-pulse,gta-community-search) pull r/gtaonline: they try Reddit's public.jsonendpoints first, and since Reddit now 403s plain HTTP, fall back to the browser session (same as gtaweb). SetBROWSE_FALLBACK=0to disable; those tools then degrade to returning the source URL. The map screenshots are captured live from gtalens.com.Refresh bundled data (uses
browseonce, keeps runtime offline):npm run refresh:toolkitβ re-pull the gtaweb economy snapshot (data/toolkit-data.json).npm run refresh:mapβ regenerate the map category catalog (data/map-categories.json).
Notes
Reset math is UTC. GTA$ figures are 2025/2026 consensus and drift with patches/bonus weeks.
The skill holds durable strategy; the MCP holds live state. They're designed to be used together.
See
gta-online-expert/SKILL.mdfor the knowledge layer.
Available Tools
28 toolsgta-best-methodsA
Rank GTA Online money-making methods by estimated GTA$/hour from the bundled reference data. Filter by category, solo-friendliness, and max setup/buy-in cost.
Inputs: category, soloFriendly, maxBuyIn, limit.
gta-business-economicsA
Current GTA Online per-business production economics decoded from gtaweb's toolkit data: full sell value (local & high-demand), capacity, mansion production multiplier, and the high-demand bonus coefficients. Bundled snapshot, refreshable.
Inputs: business.
gta-business-set-stateA
Record which GTA Online businesses you own and their current state (resupplied just now, sold just now, stock level, upgrades). Persists locally so the server tracks fill timers and cooldowns across sessions.
Inputs: businesses, remove.
gta-business-statusA
Show the current state of your tracked GTA Online businesses: estimated stock %, time-to-full, current value, sell readiness, and what to do next. Reads persisted state set via gta-business-set-state.
Inputs: no named parameters.
gta-cayo-targetsA
List the GTA Online Cayo Perico Heist primary targets and their payouts (normal and hard mode), plus secondary loot values.
Inputs: no named parameters.
gta-collectible-locationsA
Get the GTALens map link and reward info for a GTA Online collectible (all static spawn locations). Examples: gs-caches, hidden-caches, shipwrecks, signal-jammers, playing-cards.
Inputs: type (required).
gta-collectible-setsA
List GTA Online one-time collectible sets and their completion rewards (Signal Jammers, Playing Cards, Action Figures, etc.).
Inputs: no named parameters.
gta-daily-checklistA
The optimal GTA Online daily money routine: every daily-reset task with its payout and the running total (~$300k+/day).
Inputs: no named parameters.
gta-daily-collectiblesA
Today's GTA Online daily collectible income: the per-day reward table plus live tunables freshness (which day's data is loaded) from gtaweb. Falls back to the reference table if the live source is unavailable.
Inputs: no named parameters.
gta-drug-vehicleA
Today's GTA Online freemode Drug Vehicle location (sells for a bonus) + map.
Inputs: no named parameters.
gta-exotic-exportsA
Today's GTA Online Exotic Exports special-vehicle wanted list (the 10 cars to source for the Auto Shop) + map.
Inputs: no named parameters.
gta-gun-vanA
Today's GTA Online Gun Van location + map (daily discounted weapons/armor/MkII ammo).
Inputs: no named parameters.
gta-mansion-infoA
Full breakdown of the GTA Online Mansion (Prix Luxury Real Estate, 'A Safehouse in the Hills', Dec 2025): the three options, the once-daily production boost mechanics, eligible businesses, and mission payouts.
Inputs: no named parameters.
gta-map-categoriesA
List or search every GTA Online map category available on GTALens (street dealers, gun van, exotic exports, drug vehicle, collectibles, business missions, Cayo, properties, and ~100 more). Filter by group, keyword, or money-only.
Inputs: group, search, moneyOnly.
gta-map-locationsA
Get the GTALens map link and (optionally) the live location/price panel for any GTA Online map category β e.g. street-dealers, exotic-exports, gun-vans, drug-vehicle, hidden-caches. Daily categories show today's spawns.
Inputs: category (required), includeLiveData.
gta-map-screenshotA
Capture a screenshot of the GTA Online map for a category (street dealers, exotic exports, gun van, any collectible, Cayo, etc.) showing today's marker positions. Returns the image inline.
Inputs: category (required).
gta-method-detailB
Full detail and tips for one GTA Online money-making method (e.g. 'cayo-perico', 'diamond-casino-heist', 'agency-dr-dre', 'cluckin-bell').
Inputs: method (required).
gta-money-planA
The flagship planner: given your session length and goal, build a ranked, time-boxed action list that mixes passive business income with active earners so no time is wasted. Combines this week's bonuses, your tracked business state, and reset urgency.
Inputs: sessionMinutes, solo, goal.
gta-payback-calculatorA
Estimate how long a GTA Online property pays for itself: hours/runs to recoup the buy-in given a method's $/hr.
Inputs: method (required), buyIn.
gta-propertiesA
List GTA Online income properties with cost, what they unlock, and the recommended buy priority for a money empire.
Inputs: maxCost.
gta-property-detailA
Detail for one GTA Online property (cost range, what it unlocks, buy priority).
Inputs: property (required).
gta-render-categoriesA
List the bundled coordinate sets available to the offline map renderer (gta-render-map).
Inputs: no named parameters.
gta-render-mapA
Render a GTA Online map image OFFLINE (no browser): draws markers on the bundled base map from a known coordinate set OR from custom game-world coordinates you provide. Returns the image inline. Use game coords (x: -4000..4500, y: -5000..8400).
Inputs: category, points, title, color.
gta-reset-timesA
Time remaining until the GTA Online daily reset (06:00 UTC) and weekly reset (Thursday 07:00 UTC). Pure computation, always available.
Inputs: no named parameters.
gta-sell-calculatorA
Calculate a GTA Online business sell value with the high-demand public-lobby bonus (+2.5%/rival player, cap +50%) and an optional weekly 2x/3x multiplier. Uses live economy data.
Inputs: business (required), players, bonusMultiplier.
gta-street-dealersA
Today's GTA Online street drug dealers: map + the live locations and which products sell highest there.
Inputs: no named parameters.
gta-tunables-statusB
Per-platform timestamps of the last GTA Online tunables update from gtaweb (a daily-reset / new-content signal). Requires the browser fallback; degrades gracefully if unavailable.
Inputs: platform.
gta-weekly-bonusesA
This week's GTA Online event from the Rockstar Newswire: the weekly update title, 2x/3x bonus activities, podium vehicle, and discounts. Cached per weekly window; serves stale data with a note if the fetch fails.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 28 tools
Each tool targets a distinct aspect of GTA Online, from business management to heists, collectibles, and map features. Even related tools like gta-business-economics, gta-business-set-state, and gta-business-status have clearly separate purposes.
All tools follow the uniform pattern gta-<descriptive_noun_phrase> with hyphens separating words. The naming is consistent in style and length, making it easy to infer functionality from the name.
28 tools cover a wide but focused domain of GTA Online money-making. While slightly on the higher side, each tool serves a specific purpose and the set feels comprehensive without being bloated.
The tool set covers major money-making aspects: methods, businesses, heists, collectibles, properties, daily tasks, and calculators. Minor gaps exist (e.g., no direct tool for heist setups), but the overall surface is robust.
Related MCP Connectors
Free, unofficial GTA 6 server: release info, news, music, map pins, real-world landmarks, checklist
FiveM and GTA V tools: convert, merge, optimize and build resources, and make AI props and liveries.
Free Snapchat monetization rules and calculators. Core tools need no key. Not affiliated with Snap.
Sourced Grand Theft Auto VI facts: money methods and planner, vehicles, map, cheats, status.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides access to 47 AI-powered career tools for resume building, job tracking, ATS optimization, and interview coaching. It enables users to manage their job search, research companies, and negotiate salaries directly through an MCP-compatible AI assistant.557 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables automated control of TradingView Desktop via Chrome DevTools Protocol with 78+ tools for chart manipulation, Pine Script development, and indicator analysis. Supports automated morning briefs for session bias generation, replay trading practice, and multi-pane layouts with secure local-only data processing.2-
- AlicenseAqualityBmaintenanceA modular MCP server providing 64 tools across 13 modules for real-time stock and crypto market data, including scanning, technical analysis, options flow, insider trades, and personalized watchlists.39199 npm8MIT
- AlicenseAqualityCmaintenanceCross-game market intelligence and currency conversion across six MMOs, enabling unified searches, portfolio tracking, and farming optimization via MCP.6MIT