GTA Online Money Copilot — MCP server + expert skill

A two-part GTA Online money-making assistant:

gta-online-expert skill — 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 in gta-online-expert/.
gta_mcp MCP 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 to data/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.

Setup

npm install
npm run build
npm start            # stdio server
npm run smoke        # build + exercise the tools
npm run dev:inspect  # MCP Inspector UI

{
  "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 browse CLI + local Chrome): gta-map-screenshot and 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 .json endpoints first, and since Reddit now 403s plain HTTP, fall back to the browser session (same as gtaweb). Set BROWSE_FALLBACK=0 to disable; those tools then degrade to returning the source URL. The map screenshots are captured live from gtalens.com.
Refresh bundled data (uses browse once, 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.md for the knowledge layer.