# RoTerminal for agents

Live data on every Roblox game, for people and their AI agents. Free without an account.

## Three ways in

- **The command line:** `npx -y roterminal <command>`. Pretty in a terminal, JSON when an agent runs it (or with `--json`).
- **HTTP:** `GET https://roterminal.co/api/agent/<tool>?<input>` or POST JSON. Add `Authorization: Bearer rta_…` once signed in.
- **The connector (MCP):** `https://roterminal.co/mcp`. Claude Code: `claude mcp add --transport http roterminal https://roterminal.co/mcp`. Open without signing in; `me` signs you in with OAuth (Claude shows a Connect button).

## Every reply

```json
{ "status": "ok", "tool": "game", "data": { … }, "link": "https://roterminal.co/g/…", "next": [{ "command": "roterminal compare …", "tool": "compare", "input": { … }, "when": "…" }], "usage": { "used": 3, "limit": 50 } }
```

- `status`: `ok`, `error` or `action_required` (a person has to do something: show `message` and `verification_uri`, then try again).
- `reason` on the others: `login_required`, `plan_upgrade_required`, `rate_limited`, `not_found`, `missing_arguments`, `invalid_arguments`, `busy`.
- `link`: the page on roterminal.co. Cite it.
- `locked`: part of the answer is on a plan (like every day since Sep 27 on Pro), with what you'd get.

## Calls a day

No account: 50 (per address). Free account: 200. Plus: 1,000. Pro: 2,000. Studio: 5,000 per seat. Watching a game live doesn't count. Sign in: `npx -y roterminal login`.

## Tools

### A game now: `game`

Everything on one Roblox game right now: players now and its place on Roblox, the change over 1 and 24 hours, highs (24 hours, 14 days, since tracking began on Sep 27 2026), momentum and 7-day average, its genre and its place in it, its developer and the people behind it, its latest updates with how players moved after each, its closest rivals, its places on Roblox’s charts, and a 7-day line of its players (spark_7d). Start here for any question about one game.

- Command: `npx roterminal game "grow a garden"`
- HTTP: `GET https://roterminal.co/api/agent/game?game=…`
- Input:
  - `game` (required): The game: its name (like "grow a garden"), its universe id, its Roblox link or place id, or its roterminal.co/g/ link

### Day by day: `days`

One game’s players day by day (New York days, newest first): the average, peak and low, visits that day, and what happened (updates, events). Free shows the last 7 days; Pro shows every day since tracking began on Sep 27 2026 (up to 60).

- Command: `npx roterminal days "grow a garden" --days 14`
- HTTP: `GET https://roterminal.co/api/agent/days?game=…`
- Input:
  - `game` (required): The game: its name (like "grow a garden"), its universe id, its Roblox link or place id, or its roterminal.co/g/ link
  - `days`: How many days back, 1 to 60 (default 14; Free sees 7)

### Find a game: `search`

Find Roblox games by name: up to 8 matches with their universe id, developer, genre and players now, the most played first.

- Command: `npx roterminal search "dandys world"`
- HTTP: `GET https://roterminal.co/api/agent/search?query=…`
- Input:
  - `query` (required): The game’s name, or part of it

### Rising: `rising`

The Roblox games gaining players fastest, against a day ago (range 24h) or a week ago (range 7d), each with its players now and then, the change, genre, when it came out and a line of its players. Optionally one genre.

- Command: `npx roterminal rising --week --genre tycoon`
- HTTP: `GET https://roterminal.co/api/agent/rising`
- Input:
  - `range`: Against a day ago (24h, default) or a week ago (7d)
  - `genre`: Only one genre or subgenre, like Simulation, Tycoon, Tower Defense or Obby & Platformer (optional)
  - `limit`: 1 to 25 (default 10)

### Most played: `top`

A ranked list of Roblox games now. most_played: the most players right now. new: the most played games that came out in the last 30 days. Optionally one genre.

- Command: `npx roterminal top --genre simulation`
- HTTP: `GET https://roterminal.co/api/agent/top`
- Input:
  - `list`: most_played (default) or new
  - `genre`: Only one genre or subgenre, like Simulation, Tycoon, Tower Defense or Obby & Platformer (optional)
  - `limit`: 1 to 25 (default 10)

### Trends: `trends`

What developers are making games about: the words in new games’ names, by how many new games used them in the last 30 days against the 30 before, with the biggest game for each. With a word (like horror or brainrot), just that one: use it to check whether an idea has been done and how it’s doing.

- Command: `npx roterminal trends brainrot`
- HTTP: `GET https://roterminal.co/api/agent/trends`
- Input:
  - `word`: One word to look up (optional; without it, the top words)
  - `limit`: 1 to 25 (default 10)

### Compare: `compare`

Two to five Roblox games side by side now: players, change over 24 hours, momentum, genre place, latest update and its result, and a 7-day line of each one’s players.

- Command: `npx roterminal compare "grow a garden" "steal a brainrot"`
- HTTP: `GET https://roterminal.co/api/agent/compare?games=…`
- Input:
  - `games` (required): The games, by name or universe id

### Who’s behind it: `studio`

A developer (a Roblox group or one person) and the games they make, by one of their games or by name: who owns it, members, verified, their place among developers, players in all their games now, and each game with players now, visits and likes.

- Command: `npx roterminal studio "grow a garden"`
- HTTP: `GET https://roterminal.co/api/agent/studio`
- Input:
  - `game`: The game: its name (like "grow a garden"), its universe id, its Roblox link or place id, or its roterminal.co/g/ link
  - `name`: The developer’s name, when no game is known

### Screener: `screen`

Screen the 600 most played Roblox games by their numbers: genre, a theme they’re about (a word in their names and descriptions, like horror, anime or tycoon), players now, change over 24 hours or 7 days, age and likes, sorted by what you pick.

- Command: `npx roterminal screen --theme horror --max-age 30 --sort change_7d`
- HTTP: `GET https://roterminal.co/api/agent/screen`
- Input:
  - `genre`: Only one genre or subgenre, like Simulation, Tycoon, Tower Defense or Obby & Platformer (optional)
  - `theme`: A word the games are about, like horror, anime, brainrot or obby (optional)
  - `min_playing`: 
  - `max_playing`: 
  - `min_change_24h`: Percent, like 20 for up 20% or more on a day ago
  - `min_change_7d`: Percent, on a week ago
  - `max_age_days`: Only games out within this many days
  - `min_like_pct`: Like 90 for 90% likes or more
  - `sort`: 
  - `limit`: 1 to 25 (default 10)

### All of Roblox: `roblox`

Players online across all of Roblox right now, the change on a day ago and on a week ago.

- Command: `npx roterminal roblox`
- HTTP: `GET https://roterminal.co/api/agent/roblox`


### Genres: `genres`

Every genre on Roblox now: players, its share of everyone playing, the change on a day ago, how many games, its subgenres and its biggest games.

- Command: `npx roterminal genres`
- HTTP: `GET https://roterminal.co/api/agent/genres`


### Roblox’s charts: `charts`

Roblox’s own charts (Top Earning, Top Trending, Up-and-Coming and the rest), as RoTerminal keeps them day by day in 60 countries and on every device. With no chart and no game: the list of charts, countries and devices. With a chart: its games now, each with its place yesterday, its move, its best place and its days on the chart (put a country in front for one country’s chart: jp-up-and-coming is Japan’s Up-and-Coming). With a game: every place it holds on the charts now, worldwide and in each country (like JP-Up-and-Coming #4), and each chart’s summary.

- Command: `npx roterminal charts jp-up-and-coming`
- HTTP: `GET https://roterminal.co/api/agent/charts`
- Input:
  - `chart`: A chart’s id, like top-earning, top-trending or up-and-coming, with a country in front for one country’s chart, like jp-up-and-coming (optional)
  - `country`: A country as two letters, like JP, BR or US (optional; worldwide without it)
  - `device`: One device’s chart (optional; all devices without it)
  - `genre`: For top-trending: one genre’s Trending list, like RPG or Simulation (optional)
  - `game`: The game: its name (like "grow a garden"), its universe id, its Roblox link or place id, or its roterminal.co/g/ link: every place it holds on the charts now (optional)
  - `limit`: 1 to 100 (default 10)

### Updates: `updates`

Every update of one Roblox game since tracking began (Sep 27 2026), newest first: when, its title, how many versions went out, players in the hours after it against the same hours a week before, and the change; also the typical change across its updates. Free and Plus see the last 10; Pro and Studio see every one.

- Command: `npx roterminal updates "grow a garden"`
- HTTP: `GET https://roterminal.co/api/agent/updates?game=…`
- Input:
  - `game` (required): The game: its name (like "grow a garden"), its universe id, its Roblox link or place id, or its roterminal.co/g/ link
  - `limit`: 1 to 50 (default 10; Free and Plus see 10)

### Live: `live`

One game’s players this second, its place on Roblox and its 24-hour high, or up to 10 games’ at once (games). Light: made for asking again every 15 seconds (`roterminal watch`). Doesn’t count toward the day’s lookups.

- Command: `npx roterminal watch "grow a garden"`
- HTTP: `GET https://roterminal.co/api/agent/live`
- Input:
  - `game`: The game: its name (like "grow a garden"), its universe id, its Roblox link or place id, or its roterminal.co/g/ link
  - `games`: Up to 10 games at once, instead of game

### Your games: `me`

The signed-in person’s own games (the ones My Games shows them): players now against usual for this time, the latest update and how players moved after it, and today’s alerts. Needs a free RoTerminal account: `roterminal login`.

- Command: `npx roterminal me`
- HTTP: `GET https://roterminal.co/api/agent/me`