# Besitos Corp MCP

> Besitos Corp connects your AI agent directly to mobile gaming metrics and reward systems. Check game inventories, track user activity history, analyze campaign performance, and manage player incentives all from a single conversation.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** mobile-gaming, user-engagement, monetization, rewards-program, incentives, b2b-marketplace

## Description

You can use this MCP to manage the entire lifecycle of a mobile gaming rewards platform through natural chat. Instead of logging into separate dashboards for analytics, you talk to your agent and it pulls data across multiple sources—from listing available games to calculating total campaign revenue.

Need to know how many players completed level 20? Ask. Want to see if the current promotion is profitable? Ask. You can retrieve detailed user histories and monitor reward redemptions instantly. It's all about connecting your gaming data pipeline into one place, making it feel like you’re working directly with a dedicated analytics team built right into Vinkius.

This MCP gives you control over the core mechanics of user engagement, letting you oversee every aspect from initial game discovery to final revenue reporting.

## Tools

### get_campaign
Retrieves detailed information about one specific engagement campaign.

### get_engagement_report
Pulls a summary of overall user activity and performance metrics for a given period.

### get_game
Gets all the specific details about one mobile game title by its ID.

### get_offer
Retrieves full details on a single reward offer or milestone structure.

### get_revenue_report
Generates summary data about monetization and total revenue performance.

### list_campaigns
Lists every reward-based engagement campaign currently active on the platform.

### list_games
Provides a complete list of all mobile games available in the Besitos marketplace.

### list_offers
Lists all possible reward offers and milestones that can be earned by users.

### list_user_activity
Retrieves a log of gaming activity for one specific user account.

### list_user_rewards
Gets the complete reward earning and redemption history for a single user.

## Prompt Examples

**Prompt:** 
```
List all mobile games currently available in Besitos.
```

**Response:** 
```
I've retrieved the game inventory. You currently have 12 games available, including 'Strategy King' (ID: g_101) and 'Candy Blast' (ID: g_102). Would you like to see the reward structure for any of these?
```

**Prompt:** 
```
Show me the engagement report for this month.
```

**Response:** 
```
Fetching report... This month, your gaming channel has seen 5,000 active players with an average session time of 12 minutes. Total milestones completed: 850.
```

**Prompt:** 
```
Check the reward history for user_9988.
```

**Response:** 
```
User user_9988 has earned a total of $45.50 in rewards. Their last redemption was $10.00 on March 25th for completing level 20 in 'Strategy King'.
```

## Capabilities

### Discover and inspect games
List all available mobile games in the marketplace and get deep details on any specific title.

### Manage reward offers and milestones
Retrieve a list of all possible rewards, checking reward structures and promotion rules for optimization.

### Track user activity logs
Get detailed records of how specific users interact with the games—their playtime, actions, and history.

### Monitor earnings and redemptions
Check a user's complete reward history and track every time they redeem earned currency or points.

### Generate financial reports
Access summarized data on monetization, campaign performance, and overall revenue metrics.

## Use Cases

### Investigating a retention drop
The Product Manager asks the agent: 'Show me the activity logs for users who played Game X last week but haven't logged in this week.' The agent calls `list_user_activity` and cross-references it with campaign data to pinpoint where the incentive structure failed.

### Auditing a high-value account
The Support Specialist asks: 'What is user 789's complete reward history?' The agent executes `list_user_rewards`, providing a full, auditable timeline of every point earned and spent.

### Preparing for Q3 planning
The Marketing Lead asks: 'What is the revenue trend versus active players this quarter?' The agent compiles `get_revenue_report` alongside `get_engagement_report`, giving them a clear picture for budget allocation.

### Validating new game integration
The Tech Lead asks: 'List all games and check the reward requirements for the top 3.' The agent uses `list_games` followed by three calls to `get_game` combined with multiple checks of `list_offers`.

## Benefits

- Instantly check the full list of available games using `list_games`. This lets you quickly validate if a new title fits your current reward ecosystem without leaving your chat window.
- Deep dive into user behavior by calling `list_user_activity` and `list_user_rewards`. You get precise logs on what users did, when they played, and exactly how many points they spent.
- Optimize incentives using `list_offers` and `get_offer`. Before launching a campaign, you can check the reward structure to ensure it motivates the right behavior.
- Get high-level financial summaries by running `get_revenue_report` or `get_engagement_report`. You skip manual data compilation and get actionable numbers instantly.
- Manage promotions with confidence. Use `list_campaigns` to see every active promotion, then use `get_campaign` to understand its specific goals and parameters.

## How It Works

The bottom line is, you talk to your agent like a person, and it handles all the complex API calls for gaming metrics.

1. Subscribe to this MCP and input your Besitos Partner API Key.
2. Connect it to your preferred AI client (Claude, Cursor, etc.)
3. Ask your agent to perform the required analysis or data retrieval.

## Frequently Asked Questions

**How do I check if an offer is available using get_offer?**
You pass the specific ID of the reward to `get_offer`. This tool returns all rules associated with that single milestone, letting you know exactly how a user earns it or if it's currently restricted.

**Can I find out what games are available using list_games?**
Yes. Calling `list_games` provides the full inventory of titles in the marketplace, allowing you to get details on any specific game with the `get_game` tool.

**What data can I pull about a user using list_user_activity?**
The agent pulls detailed logs showing exactly what the user was doing in-game. This helps you understand their behavior patterns, not just their score.

**How do I see all running promotions? Should I use list_campaigns or list_offers?**
Use `list_campaigns` to see the overarching promotional initiatives. Then, if you need specific rules for one of those campaigns, check the available rewards using `list_offers`.

**Is get_revenue_report better than get_engagement_report?**
They track different things: `get_engagement_report` measures user activity (how many people played for how long), while `get_revenue_report` tracks the money coming in from those activities.

**If I use get_game with an ID that doesn't exist, what kind of error message should I expect?**
The system returns a clear 404 status code and a detailed JSON payload. This response tells you exactly why the game wasn't found or if the ID format was wrong.

**When running list_user_rewards, does the tool show me the user’s current total reward balance?**
Yes, it provides a summary field showing the user's cumulative reward value. You get a full ledger of every earning and redemption event for transparency.

**If I need to list_campaigns that have hundreds of entries, do I run into rate limits?**
No, the API automatically handles pagination using tokens. The initial response includes a token you use to fetch subsequent pages of campaign data.

**Can I check which games are currently trending in the marketplace?**
Yes! Use the `list_games` tool to see all available titles. You can then use `get_game` to see specific metadata and performance metrics for each game.

**How do I monitor the revenue generated by my gaming channel?**
Simply ask the agent to `get_revenue_report`. It will retrieve a summary of monetization data, including total earnings and performance by campaign.

**Does the integration allow me to verify a specific user's reward status?**
Yes. Use the `list_user_rewards` tool with the User ID. Your agent will fetch the full history of earned rewards and pending redemptions for that user.