convez.ai
MCP Server
IvanKuria

bloxscout

IvanKuria/bloxscout

Ver no GitHub
BomPluginScore · de 0 a 100

Reconnaissance for Roblox game devs and their agents — open-source MCP server + CLI for Roblox game analytics.

Instalação

$npx convez-ai IvanKuria/bloxscout

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
1
Acompanhando
0
Saúde
100%
Último commit
há 4 meses
Versão
bloxscout-mcp-v0.1.0
Issues abertas
53
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

bloxscout

Reconnaissance for Roblox game devs and their agents.

npm version CI License: MIT MCP Server

What is Bloxscout?

Roblox developers operate one of the largest game platforms in the world, yet most market-intelligence tools they rely on (chiefly rotrends.com) have no public API. That means a developer cannot ask their AI agent simple questions like "which Simulator games are trending this week?", "how does my game's CCU compare to the genre median?", or "what would a 20,000 Robux DevEx payout net me in USD?" without leaving their editor, copy-pasting between tabs, and re-explaining context every time.

Bloxscout closes that gap. It is an open-source TypeScript Model Context Protocol (MCP) stdio server (bloxscout-mcp) that exposes 20 tools across discovery, game intelligence, creator/community lookup, calculators, snapshots, and reports — all backed by Roblox's public unauthenticated endpoints and (optionally) Open Cloud for the user's own games.

New in v0.2: hosted historical data. Bloxscout runs an open ingestion pipeline that snapshots thousands of popular Roblox games every ~30 minutes and publishes the rollups as static JSON in the public bloxscout-data repo. The tools read it over plain HTTPS — so get_trending_games returns real 24h/7d growth from your very first call, get_breakout_games flags statistically anomalous CCU spikes, and get_genre_momentum shows which niches are rising — with no API key, no signup, and no waiting for a local store to fill up. The local SQLite snapshot store (~/.bloxscout/data.db) is still there for niche games the pipeline doesn't track and for finer-grained windows; everything degrades gracefully to local/live behavior when you're offline (or set BLOXSCOUT_NO_HOSTED=1).

Quick start (MCP)

Bloxscout is MCP-first — its primary user is an LLM agent inside Claude Code, Cursor, Windsurf, or Zed.

Claude Code

claude mcp add bloxscout -- npx -y bloxscout-mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "bloxscout": {
      "command": "npx",
      "args": ["-y", "bloxscout-mcp"]
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json)

{
  "mcpServers": {
    "bloxscout": {
      "command": "npx",
      "args": ["-y", "bloxscout-mcp"]
    }
  }
}

Zed (~/.config/zed/settings.json)

{
  "context_servers": {
    "bloxscout": {
      "command": {
        "path": "npx",
        "args": ["-y", "bloxscout-mcp"]
      }
    }
  }
}

Once registered, ask your agent things like "Use bloxscout to find the top 10 trending Simulator games and tell me which ones are growing fastest week-over-week."

What can it do?

Discovery

ToolDescription
search_gamesSearch Roblox's catalog by keyword with optional genre and sort filters.
get_trending_gamesRank games by real 24h CCU growth (hosted dataset), with a live current-CCU fallback.
get_top_by_genreList the top games within a specific genre ranked by CCU or visits.
get_up_and_comingSurface smaller games with unusually strong recent growth.
get_breakout_gamesDetect games whose trailing-24h CCU is statistically anomalous vs their own prior week.
get_genre_momentumRank genres by momentum: summed CCU plus 24h/7d growth of the genre as a whole.

Game intelligence

ToolDescription
get_gameFetch a single game's full metadata: name, description, creator, stats, thumbnails.
get_game_player_countReturn current CCU and total visits for a given universe ID.
get_game_historyHistorical CCU/visits/favorites for a game — hosted dataset merged with your local snapshots.
compare_gamesSide-by-side comparison of up to N games on the same metrics.
analyze_game_vs_genreCompare one game against the median/percentile of its genre cohort.

Creator and community

ToolDescription
get_creatorLook up a user or group creator with bio, follower count, and verification status.
get_groupFetch a group's metadata, member count, and recent activity.
get_top_creators_by_genreIdentify the most successful creators within a specific genre.

Calculators

ToolDescription
calculate_devexConvert Robux to USD via the current DevEx rate.
estimate_game_revenueEstimate gross Robux revenue from visits, CCU, and monetization assumptions.

Operational

ToolDescription
snapshot_gameCapture a point-in-time snapshot of a game into the local SQLite store.
watch_gamesSchedule recurring snapshots for a set of games to build time-series.

Reports

ToolDescription
generate_market_reportProduce a structured market report (Markdown + JSON) for a genre or watchlist.

Data sources

Bloxscout reads from:

  • games.roblox.com — game metadata, search, sort
  • apis.roblox.com — omni-search and explore-api discovery sorts
  • groups.roblox.com — group metadata
  • users.roblox.com — user metadata
  • thumbnails.roblox.com — game and creator thumbnails
  • bloxscout-data — open hosted dataset of historical game metrics (static JSON over GitHub's CDN; refreshed ~every 30 min; opt out with BLOXSCOUT_NO_HOSTED=1, mirror with BLOXSCOUT_HOSTED_BASE_URL)
  • Roblox Open Cloud — optional, authenticated, only for games you own
  • Local SQLite snapshot store at ~/.bloxscout/data.db — for historical time-series you build yourself

Disclaimer: Bloxscout is an unofficial tool. It is not affiliated with, endorsed by, or sponsored by Roblox Corporation or Super League Enterprise / Rotrends. Data is sourced from Roblox's public unauthenticated endpoints (games.roblox.com, presence.roblox.com, groups.roblox.com, users.roblox.com).

Contributing

Contributions are welcome. Start with CONTRIBUTING.md, and look for issues tagged good first issue.

License

Licensed under the MIT License.

Disclaimer

Bloxscout is an unofficial tool. It is not affiliated with, endorsed by, or sponsored by Roblox Corporation or Super League Enterprise / Rotrends. Data is sourced from Roblox's public unauthenticated endpoints (games.roblox.com, presence.roblox.com, groups.roblox.com, users.roblox.com).

Ver o original no GitHub

Bom para

Relacionados