# Decentraland MCP for AI Agents AI Agent Connect

> Decentraland (Virtual World Content API) MCP gives your AI agent a direct window into the metaverse. Track hot scenes, find community events, analyze parcel traffic, and browse the marketplace in real time. It turns your AI into a dedicated scout for the Decentraland ecosystem.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_UwmDlmhbp29l0rqwvsCJxFZkgWzxfL4xJnQLg9xa/ai-agent-connect
- **Tags:** metaverse, decentraland, web3, virtual-world, nft-marketplace

## Description

The Decentraland (Virtual World Content API) MCP gives your AI agent a direct window into the metaverse. Instead of digging through maps or refreshing marketplace tabs, you can just ask your agent to find the best spots to hang out or check the status of your own land. It pulls live data on user counts, upcoming community events, and the current state of the marketplace. If you are looking for a specific vibe, the agent can filter scenes by popularity or coordinates. You can also keep an eye on the health of the infrastructure or browse wearable listings to see what is trending in the virtual economy. When you add this to the Vinkius catalog, you get a direct line into the metaverse. It turns your AI into a dedicated scout that handles the data heavy lifting for you.

## Tools

### get_hot_scenes
See where the crowds are gathering right now. It shows live user counts for the most popular spots.

### get_main_realm_about
Get the specific configuration and details for the main realm. This helps you understand the optimal setup for the world.

### get_marketplace_catalog
Browse the full list of wearables and emotes. You can filter these items to find exactly what you want in the marketplace.

### get_marketplace_items
Look up specific NFT items and their trade history. It provides details on individual assets within the Decentraland economy.

### update_place_rating
Change the content rating for a specific location. This tool is for authorized users who need to keep the world safe.

### get_parcel_stats
Check the number of users on a specific piece of land. This is perfect for monitoring traffic on your own parcel.

### list_places
Find specific scenes using filters like popularity and coordinates. It helps you narrow down locations based on your interests.

### get_realms
List all healthy catalyst realms. It also shows you how many users are in each one.

### list_attending_events
See a list of events you are currently signed up for. It helps you keep your personal metaverse schedule organized.

### get_catalyst_about
Check the health and configuration of the catalyst services. Use this to see if the infrastructure is running smoothly.

### create_auth_request
Start the authentication process for your account. This is required for actions that need your permission.

### create_event
Create a new community event in the metaverse. This allows you to host your own gatherings for others to join.

### list_destinations
Get a unified list of Genesis City places and Worlds. It provides a broad overview of where you can go.

### list_events
See a list of all active and upcoming community events. Use this to stay updated on what is happening.

### get_auth_request
Check the status of your current authentication request. It lets you know if your login process is complete.

## Prompt Examples

**Prompt:** 
```
Where are people hanging out right now?
```

**Response:** 
```
I've scanned the metaverse for the most active spots! Here are the top 3 scenes currently trending:

| Location | User Count | Status |
| :--- | :--- | :--- |
| **Genesis Plaza** | 142 | Very Active |
| **WonderMine** | 88 | Active |
| **Dragon City** | 54 | Moderate |

Would you like the coordinates for any of these?
```

**Prompt:** 
```
What events are happening this weekend?
```

**Response:** 
```
There are several community gatherings scheduled for this weekend:

* **Metaverse Music Festival** (Saturday, 2 PM UTC)
* **Community Town Hall** (Sunday, 4 PM UTC)
* **Art Gallery Opening** (Saturday, 8 PM UTC)

I can pull the full list of 12 events if you'd like to see more details.
```

**Prompt:** 
```
Find me some art galleries near the center.
```

**Response:** 
```
I found a few highly-rated art spaces near the center coordinates:

* **Sotheby's Gallery** (Rating: 4.9) - Located at (1,1)
* **MUSE Art Space** (Rating: 4.7) - Located at (-2,3)

Both are currently active and have high visitor ratings.
```

## Capabilities

### Track live popular scenes
Find where the crowds are gathering right now with real user counts.

### Find community events
See what is happening in the metaverse with a list of active and upcoming gatherings.

### Monitor land traffic
Check the exact number of users on any specific piece of land.

### Browse marketplace items
Filter and browse wearables and emotes within the Decentraland economy.

### Check realm health
Get real-time status and configuration for catalyst services and realms.

### Update content ratings
Modify the rating of a specific place to manage content safety.

## Use Cases

### Finding a party without the manual search
An explorer asks their agent to find the top 5 hot scenes near them. The agent uses get_hot_scenes and list_places to provide a curated list of active parties.

### Monitoring land owner traffic
A land owner wants to know if their parcel is busy. They ask the agent to check the user count, which triggers get_parcel_stats for instant feedback.

### Market research for wearables
A creator wants to see what is trending. They ask the agent to browse the marketplace catalog using get_marketplace_catalog to see current listings.

### Checking realm stability
A power user wants to know if the main realm is healthy. The agent uses get_catalyst_about to provide a status report on the current infrastructure.

## Benefits

- Spot popular scenes instantly using get_hot_scenes to see where the crowd is.
- Monitor land traffic with get_parcel_stats to see exactly who is on your property.
- Browse the economy via get_marketplace_catalog to find trending wearables and emotes.
- Keep your personal schedule organized with list_attending_events for all your signups.
- Keep the world safe with update_place_rating to manage content for specific locations.
- Audit infrastructure health with get_catalyst_about to ensure the metaverse is running well.

## How It Works

The bottom line is your AI agent handles the data fetching so you can navigate the metaverse without opening extra tabs.

1. Subscribe to the Decentraland MCP through the Vinkius marketplace.
2. Provide your Bearer Token if you need to manage events or update ratings.
3. Ask your agent to find scenes, check parcel stats, or browse the marketplace.

## Frequently Asked Questions

**Can I use the Decentraland MCP to find active parties?**
Yes. You can ask your agent to find the most popular scenes right now, and it will return a list of active locations with real-time user counts.

**How does the Decentraland MCP help land owners?**
It allows you to monitor traffic on your specific land parcels. You can ask for the exact user count on any parcel to see how many people are visiting.

**Can I browse the marketplace with this tool?**
Yes. You can ask your agent to browse the marketplace for specific items like wearables or emotes, and it can even pull up trading history for specific NFTs.

**Does the Decentraland MCP show me my own schedule?**
If you are an authorized user, your agent can list all the events you are currently signed up to attend, helping you keep your metaverse schedule organized.

**How do I check if a metaverse realm is healthy?**
The Connector can check the real-time health and configuration of the catalyst services, so you can quickly see if the infrastructure is running smoothly.

**Can I use the Decentraland MCP to manage community events?**
Authorized users can use the Connector to create new community events and manage the content ratings of various places to ensure a safe environment.

**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.