# Decentraland MCP

> Decentraland Virtual World Content API MCP lets your AI client explore the metaverse's content layer directly. Track popular virtual scenes using real-time user counts, list upcoming community events, or analyze parcel statistics for land ownership insights. You can browse the entire marketplace and even update place ratings from within your agent.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** metaverse, decentraland, web3, virtual-world, nft-marketplace

## Description

Need to know what’s happening in a virtual world? This MCP gives your AI client direct access to Decentraland's content layer, letting you interact with live world data and community activities through plain conversation. Instead of opening multiple browser tabs and digging through external maps, you simply ask your agent for the stats you need. It pulls real-time details about where people are gathering or what events are happening this weekend. You can also check the marketplace catalog to see the latest wearables and items without lifting a finger. Vinkius hosts this MCP so any compatible AI client, like Cursor or Claude, gets instant access to these functions. It’s deep world data for your agent to use—whether you're planning an event or analyzing land value.

## Tools

### list_attending_events
Retrieves a list of community events that your authenticated account is scheduled to attend.

### get_catalyst_about
Retrieves essential operational health and configuration details for all underlying platform services.

### create_auth_request
Starts the process required to authenticate your agent with the platform.

### create_event
Creates a new community gathering event, requiring authentication credentials.

### list_destinations
Provides a unified list grouping Genesis City places and various Worlds for easy navigation.

### list_events
Returns an active or upcoming schedule of community-wide events in the area.

### get_auth_request
Checks the status of an existing authentication request to confirm access rights.

### get_hot_scenes
Pulls real-time data showing the most popular and active gathering spots right now.

### get_main_realm_about
Gets detailed configuration information for the primary, optimal realm within the virtual world.

### get_marketplace_catalog
Allows browsing and filtering of digital wearables and emotes listed in the marketplace.

### get_marketplace_items
Queries specific NFT items, providing details on their current status and trading history.

### get_parcel_stats
Provides user counts for individual parcels across the map to assess localized activity levels.

### list_places
Searches and filters for scenes using criteria like popularity, coordinates, or keywords.

### get_realms
Lists all currently healthy and operational catalyst realms, along with their user populations.

### update_place_rating
Updates the content rating of a specific place; this action is restricted to administrators or moderators.

## Prompt Examples

**Prompt:** 
```
Show me the top 5 hot scenes in Decentraland right now.
```

**Response:** 
```
I've found the most active spots! Currently, 'Genesis Plaza' has 120 users, followed by 'WonderMine' with 85, and 'Dragon City' with 60. Would you like the coordinates for any of these?
```

**Prompt:** 
```
List all upcoming events for this weekend.
```

**Response:** 
```
There are several exciting events scheduled! I see a 'Metaverse Music Festival' starting Saturday at 2 PM UTC and a 'Community Town Hall' on Sunday. I can provide the full list of 12 events if you'd like.
```

**Prompt:** 
```
Search for scenes related to 'art galleries' near coordinates 0,0.
```

**Response:** 
```
Searching near the center... I found 'Sotheby's Gallery' at (1,1) and 'MUSE Art Space' at (-2,3). Both are highly rated and currently active.
```

## Capabilities

### Track live location popularity
Find the most populated scenes and places by checking real-time user counts.

### Manage virtual events
List upcoming community gatherings or check specific event schedules for authenticated users.

### Analyze world statistics
Get data on the overall health of the metaverse infrastructure and user distribution across parcels.

### Browse virtual assets
Access and filter listings for wearables, emotes, and catalog items in the Decentraland Marketplace.

### Moderate content rating
Authorized users can update a place's content rating to maintain safety standards for explorers.

## Use Cases

### Planning a Major Launch Event
A marketing lead needs to know the optimal time for their virtual party. They ask their agent to run `list_places` filtered by 'high traffic' and combine that with checking `get_hot_scenes` data. The agent reports three windows of peak activity, allowing them to schedule maximum attendance.

### Auditing Land Performance
A land owner wants to prove the value of their digital property. They ask their agent to run `get_parcel_stats` over a week and compare it against neighboring parcels, using the data to justify a sale price.

### Researching World Trends
A research analyst needs infrastructure metrics for a report. They instruct their agent to query `get_catalyst_about` and pull user distribution maps via `get_realms`, building a comprehensive technical profile of the platform.

### Curating Content Safety
A moderator notices an unsafe gathering spot. They use their permissions to run `update_place_rating` and assign a higher content rating, protecting other users from poor experiences.

## Benefits

- Find immediate hotspots: Instead of guessing, use `get_hot_scenes` to instantly identify the most active spots in the metaverse based on user density.
- Plan ahead with events: Use `list_events` to pull a full schedule of upcoming community gatherings for marketing or personal planning.
- Understand asset value: Check the marketplace using `get_marketplace_catalog` and analyze specific assets via `get_marketplace_items` before buying anything.
- Monitor your investment: Run `get_parcel_stats` to track real-time user counts on your land, giving you a metric for its current engagement level.
- Know the big picture: Get overall world health data by running `get_catalyst_about` or checking all active realms with `get_realms`.

## How It Works

The bottom line is, your AI client treats Decentraland like another API endpoint, letting you pull complex, live world data with simple prompts.

1. First, you connect your preferred AI client to this MCP and provide any required Decentraland Bearer Token for authenticated actions.
2. Next, your agent uses natural conversation to invoke specific functions, like asking 'What are the hottest scenes?' or 'List events in June.'
3. Finally, your agent receives structured data—be it a list of upcoming festivals or parcel user counts—that you can use immediately.

## Frequently Asked Questions

**How do I find out which parts of Decentraland are most popular using get_hot_scenes?**
The `get_hot_scenes` tool gives you real-time data on the currently most active spots. It reports user counts for specific locations, letting you know where the community is gathering right now.

**Do I need to use create_auth_request before listing events?**
Yes. Many actions, including using `list_attending_events`, require proper credentials. You must run `create_auth_request` first to establish your agent's access rights.

**What is the difference between list_places and get_hot_scenes?**
Use `list_places` when you want to search for potential locations by criteria like coordinates or keywords. Use `get_hot_scenes` only when you need a live report on which spots are currently most crowded.

**Can I check my land's performance with get_parcel_stats?**
Absolutely. This tool gives you the specific user count for your parcel, letting you track local engagement without looking at generalized world data.

**How do I check if my credentials are valid or if an authentication request was successful using get_auth_request?**
It returns the current status of your connection attempt. If it shows a 'SUCCESS' status, you can confidently execute authenticated actions like creating an event or updating ratings.

**What specific details about an NFT item can I retrieve using get_marketplace_items?**
This tool queries detailed records for individual assets. You provide the item ID and receive its full transaction history, including previous owners and sale dates—essential data for tracking value.

**If I need to know about general infrastructure health, what does running get_catalyst_about show me?**
It retrieves the real-time operational status and configuration of all core catalyst services. This helps you determine if a problem is localized or if the entire metaverse infrastructure needs attention.

**Does update_place_rating require special permissions, and how do I use it for moderation?**
Yes, this tool requires moderator or admin credentials. You must supply the target place's ID and a new rating value; this process ensures content quality for all explorers.

**How can I find the most crowded places in Decentraland right now?**
You can use the `get_hot_scenes` tool to get a real-time list of popular scenes with active user counts, or `get_parcel_stats` for a granular view of user distribution across coordinates.

**Can I see what events are happening today?**
Yes! The `list_events` tool retrieves all active and upcoming community-organized events, including their descriptions and locations.

**Is it possible to search for specific scenes by name or coordinates?**
Absolutely. Use the `list_places` tool with the `search` parameter for names or the `coordinates` parameter (e.g., "-23,-96") to find content in specific areas.