# Roblox Social & Group Intelligence MCP

> Roblox Social & Group Intelligence is a deep-dive toolset for mapping the Roblox social graph. It lets your AI agent pull structured data about user profiles, group ownership, friend lists, and real-time online status. You can resolve usernames to unique IDs, audit entire group rank structures (Admin, Moderator), and track who's currently active in specific games—all without needing complex external scripts. This is for anyone treating Roblox as a live, structured database.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** social-graph, user-profiles, presence-tracking, group-management, identity-verification

## Description

**Roblox Social Intelligence** gives your AI client deep access to the **Roblox social graph**. You can map out user relationships and audit entire group structures without running any complex external scripts or dealing with slow web scraping. This server treats Roblox like a live, structured database—and that's what you get.

If you need an account's unique ID but only have the username, run `search_roblox_user` to resolve that name into the necessary AccountID. Once you have the ID, you can grab the full profile metadata for any user using `get_user_profile`. This tool pulls core details and also gets a list of every badge that account has earned via `get_user_badges`. 

To build out social connections, your agent uses specific endpoints. You'll get an official friend list with `get_user_friends` or pull all the accounts following a user using `get_user_followers`. If you want to see who that specific user is watching, use `get_user_followings`. This lets you map out both incoming and outgoing connections for any profile.

When it comes to groups, you can do some serious auditing. You can pull general group metadata—like the group's name and its total member count—by calling `get_group_details`. For deeper ownership insights, run `get_group_roles` to list every rank available inside a group and understand the entire hierarchy structure, from Admin down to basic Member. You're auditing the whole chain of command.

Monitoring presence is simple too. Use `get_users_online_status` to check if multiple user IDs you specify are currently online or playing an active game experience at the same time. This gives you real-time data on activity levels across several accounts. You can then combine this with the profile data to build out a complete picture of who's logged in and what they're doing.

## Tools

### get_group_details
Fetches general metadata for a specific Roblox group, including its name and member count.

### get_group_roles
Lists every rank and role available within a specified group, detailing the hierarchy structure.

### get_user_badges
Retrieves all unique badges earned by a Roblox user account ID.

### get_user_followers
Lists the accounts that are currently following a specified Roblox user.

### get_user_followings
Lists all users that a given Roblox user is actively following.

### get_user_friends
Provides the official list of accounts marked as friends for a specific Roblox user ID.

### get_user_profile
Retrieves the complete profile metadata for any Roblox user, given their unique account ID.

### get_users_online_status
Checks if multiple specified users are currently online or playing an active game experience.

### search_roblox_user
Finds and resolves a Roblox user's unique AccountID using only their public username.

## Prompt Examples

**Prompt:** 
```
Find the UserID for the Roblox user 'Builderman' and show his friend list.
```

**Response:** 
```
Resolving username... I've found the account for 'Builderman' (ID: 156). I've also retrieved his public friend list which includes 68 users. Would you like to see his current presence status or account history?
```

**Prompt:** 
```
Analyze the group ID '1' and list all available ranks and the owner.
```

**Response:** 
```
Inspecting group metadata... Group ID '1' (Roblox) is owned by 'Builderman'. It has over 2 million members. I've retrieved the rank structure including 'Member', 'Moderator', and 'Admin'. Would you like the full list of members in a specific rank?
```

**Prompt:** 
```
Check if user IDs '123, 456, 789' are currently playing any game together.
```

**Response:** 
```
Running batch presence check... Users 123 and 456 are currently in the same experience: 'Work at a Pizza Place'. User 789 is currently offline. Shall I continue monitoring their status for any changes?
```

## Capabilities

### Map User Connections
The agent can fetch a user's complete friend list or follow list, building out the social graph for analysis.

### Audit Group Hierarchy
You can pull all roles and ranks within a group to understand its internal structure and ownership chain.

### Check Real-Time Status
Monitor multiple user IDs simultaneously to see if they are currently online or active in a game experience.

### Retrieve Core Profiles
Get comprehensive profile metadata for any Roblox user, including their unique AccountID and badges earned.

## Use Cases

### Identifying Group Power Players
A community manager needs to know who has administrative power in a large group. They ask the agent to analyze the group ID, and the agent uses `get_group_roles` to list every rank and confirm which members hold 'Admin' status. This immediately pinpoints the core leadership team.

### Tracking Competitive Activity
A scout needs to track if a rival player is active with their main group contacts. They feed the agent three user IDs and run `get_users_online_status`. The agent confirms which users are currently 'In-Game' together, giving real-time intelligence.

### Mapping Influencer Reach
A data analyst wants to see the full circle of an account. They first run `get_user_profile` to get the AccountID, then use `get_user_followers` and `get_user_friends`. The agent combines these two lists to build a comprehensive map of influence.

### Verifying Account Status
A user suspects an account might be spoofed or inactive. They run `get_user_badges` and `get_user_profile`. The agent returns the full badge history and current status, allowing the user to verify if the profile matches expectations.

## Benefits

- Track social connections with `get_user_friends` and `get_user_followers`. Instead of clicking through pages to see who follows whom, your agent builds the entire graph instantly. This is huge for tracking influence.
- Audit group structure using `get_group_roles` and `get_group_details`. You don't just get a member count; you get the full rank breakdown (e.g., 10 Admins, 50 Mods). It tells you exactly who runs the place.
- Check presence with `get_users_online_status`. Need to know if three key people are grouped together right now? You run a batch check and get an immediate yes/no answer for everyone involved. No guessing.
- Profile deep dives using `get_user_profile` and `get_user_badges`. You pull all the canonical data—bio, ID, badges—in one go. It's like getting the full dossier on a user without leaving your chat window.
- Resolve names instantly with `search_roblox_user`. If you only have a username, this tool gives you the unique AccountID needed for every other function. It solves the hardest step first.

## How It Works

The bottom line is: You ask for social data; the agent runs specialized tools and gives you the JSON payload it gets back.

1. First, ask your agent to find a user by name. It runs `search_roblox_user` to get the required UserID.
2. Next, tell it which data point you need—like badges or friends. The agent then calls the specific tool (e.g., `get_user_badges`) using that ID.
3. The server returns a clean, structured list of data, which your agent presents directly back to you.

## Frequently Asked Questions

**How do I find a user ID for 'Builderman'? (Using search_roblox_user)**
You run `search_roblox_user` with the username. It immediately returns the unique AccountID, which you then use for all other lookups like checking their profile or badges.

**Can I check if multiple users are online at once? (Using get_users_online_status)**
Yes, that's what `get_users_online_status` does. You pass a list of user IDs and the tool checks their current status across all specified accounts.

**What is the difference between get_user_friends and get_user_followers? (Using both tools)**
Friends are people who have officially accepted you as a friend. Followers are anyone who has chosen to track your activity, even if they aren't mutual friends.

**How do I analyze the group structure? (Using get_group_roles)**
Use `get_group_roles` with the Group ID. This tool lists every rank available and shows which specific roles exist within that organizational unit, detailing the hierarchy.

**What does the `get_user_profile` tool return besides the basic username and ID?**
It returns core metadata like bio text, join date, and account status. This profile data is essential for verifying a user's identity against public records.

**Is there a functional difference between using `get_user_friends` and `get_user_followings`?**
Yep, they track different relationships. 'Friends' implies a mutual connection status on the platform. 'Followings,' however, just lists users you are actively observing or tracking.

**How do I use `get_user_badges` to audit all badges earned by a user?**
The tool retrieves currently active and public badges. If you need an exhaustive historical record, multiple calls might be necessary depending on the data's scope.

**If I run many queries in quick succession, how does the system handle rate limits?**
The server manages standard throttling for batch requests. For continuous, large-scale collection, you should pace your calls using an exponential backoff strategy to ensure stability.

**Can my AI automatically find the UserID of a player if I only have their username?**
Yes! Use the `search_roblox_user` tool. Your agent will query the official Users database and return the unique identifier required for all other social, group, and presence queries.

**How do I check the full rank structure and member count of a Roblox group?**
Simply provide the Group ID to the agent. It will run tools like `get_group_details` and `get_group_roles` to fetch the complete organizational hierarchy and total population of the group.

**Is it possible to monitor if a list of several users are currently in the same game?**
Yes. The `get_users_online_status` tool accepts multiple UserIDs and retrieves their real-time status. The agent can then identify if they are active in the same Place ID or different experiences.