# Tabletop Campaign XP Planner AI Agent Connect

> Tabletop Campaign XP Planner MCP gives Game Masters precise control over character progression. It handles everything from calculating current party XP to simulating encounter rewards and forecasting when your players will hit their next level. Stop manual math during sessions and let your AI client manage the numbers.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_CufI7bDel7Rqq5ygsw1rJ6eQgqYGsYbsrxekXtsk/ai-agent-connect
- **Tags:** ttrpg, game-master, xp-tracker, character-progression, campaign-management

## Description

Running a tabletop RPG requires keeping track of a lot of moving parts, and character progression shouldn't be a math headache during your session. This MCP gives you a set of tools to manage XP and leveling with precision. You can get an instant snapshot of where every player stands in the party or simulate how a specific combat encounter will impact their progress before you even roll the dice. If you want to plan your campaign pacing, you can project exactly how many sessions it will take for the group to reach a milestone. When the party completes a major story arc, you can distribute large XP rewards using specific rules to keep things fair. It turns your AI client into a dedicated progression assistant that handles the bookkeeping while you focus on the story.

## Tools

### allocate_milestone_xp
This tool handles the distribution of large, narrative-driven XP rewards for the party.

### calculate_party_progress
This tool provides a snapshot of the current XP status for both individual characters and the entire group.

### project_leveling_timeline
This tool predicts when the party will reach specific future levels based on current progress.

### simulate_encounter_reward
This tool calculates the XP gained from a specific event and applies it to the party members.

## Prompt Examples

**Prompt:** 
```
What is the current progress of my party?
```

**Response:** 
```
The party has a total of 4,500 XP. Character A is level 3 (80% to level 4), Character B is level 2 (45% to level 3), and Character C is level 2 (10% to level 3).
```

**Prompt:** 
```
How much XP will the party get from a hard encounter with 1500 base XP for 4 players?
```

**Response:** 
```
With a hard difficulty multiplier of 2.0, the total XP gained is 3,000. Each of the 4 players will receive 750 XP.
```

**Prompt:** 
```
When will the party reach level 5?
```

**Response:** 
```
Based on your average of 500 XP per session and playing once a week, the party is estimated to reach level 5 in 4 sessions (approximately 4 weeks).
```

## Capabilities

### XP Distribution
The AI calculates rewards for both small encounters and major narrative milestones.

### Progress Tracking
Your agent can pull current XP totals and level percentages for every player.

### Pacing Projections
The AI estimates the number of sessions needed to reach upcoming level milestones.

### Reward Simulation
You can test how different difficulty multipliers affect the XP your players receive.

## Use Cases

### End of Session Cleanup
Quickly distribute XP to all players after a combat or story event.

### Campaign Pacing
Determine if your players are leveling too fast or too slow for your planned story.

### Encounter Balancing
Check how much XP a specific monster encounter will provide before you run it.

### Milestone Planning
Set specific levels for the party to reach and see how many sessions that will take.

## Benefits

- Removes manual XP math from the game session.
- Provides predictable leveling timelines for campaign planning.
- Allows for testing encounter difficulty against XP rewards.

## How It Works

Connect the MCP to your preferred client and start managing your campaign data.

1. Connect your AI client to Vinkius.
2. Select the Tabletop Campaign XP Planner MCP.
3. Ask your agent to calculate or simulate XP rewards.
4. Review the projected leveling timelines for your players.

## Frequently Asked Questions

**How do I use this with Claude or Cursor?**
You connect once through the Vinkius interface, and the tools become available in your AI client's toolset immediately.

**Can I simulate different difficulty levels?**
Yes, you can use the simulation tool to see how different multipliers affect the XP your party earns.

**Does this track individual player levels?**
Yes, the MCP can provide a breakdown of XP and level progress for every individual in the party.

**How does it predict future levels?**
It uses your current XP averages and session frequency to estimate when the next level-up will occur.

**How does the XP distribution work?**
You can use `simulate_encounter_reward` for standard encounters or `allocate_milestone_xp` for narrative milestones. The latter allows for equal or level-weighted distribution to ensure fair progression.

**Can I predict when my players will level up?**
Yes, by using `project_leveling_timeline`, you can estimate the number of sessions, weeks, or days required to reach a specific target level based on your average XP per session.

**How do I check the current status of my party?**
The `calculate_party_progress` tool provides a detailed report including current levels, XP needed for the next level, and progress percentages for every character.