# Rpg Mcp

> Simple MCP server with functions for LLM Game Mastering

- **Type:** MCP server
- **Install:** `agentstack add mcp-jnaskali-rpg-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jnaskali](https://agentstack.voostack.com/s/jnaskali)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jnaskali](https://github.com/jnaskali)
- **Source:** https://github.com/jnaskali/rpg-mcp

## Install

```sh
agentstack add mcp-jnaskali-rpg-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# RPG MCP Server

A simple MCP (Model Context Protocol) server for playing RPGs with Large Language Models. It provides tools for dice rolling, success checks, and random event generation.

---

---

## Features

- **`check_success(probability, critical_rate)`** - Determines success/failure with optional critical results
- **`roll_dice(expr)`** - Rolls dice using standard RPG notation (e.g., '1d6', '2d8+3')
- **`generate_event()`** - Generates random RPG events for plot twists and surprises
- **`list_tools()`** - Lists all available tools

## Installation

### Prerequisites

- Python 3
- [uv](https://docs.astral.sh/uv/) - A fast Python package installer

### Setup

1. Clone the repository:
```bash
git clone https://github.com/jnaskali/rpg-mcp.git
cd rpg-mcp
```

2. Install dependencies with uv:
```bash
uv sync
```

### Configuration

Add the following to your MCP client's configuration file (e.g., `mcp.json` in Claude Desktop or other MCP-compatible clients):

```json
{
  "mcpServers": {
    "rpg-mcp": {
      "command": "/usr/bin/uv",
      "args": [
        "run",
        "python",
        "app.py"
      ],
      "cwd": "/PATH_TO/rpg-mcp/"
    }
  }
}
```

Replace `/PATH_TO/rpg-mcp/` with the actual path to your rpg-mcp directory.

## Usage

Once configured, the LLM can call the tools to:

- Roll dice for attacks, damage, or skill checks
- Determine action outcomes with customizable success probabilities
- Generate random events to drive the narrative forward

### Example Prompt

Include instructions in your prompt like:

> "Call check_success whenever a player character attempts something with a chance of failure, and generate_event to generate a random event at the start of a new scene or when moving to a new location."

The event generation system is inspired by [Mythic Game Master Emulator](https://www.wordmillgames.com/page/mythic-gme.html).

> [!IMPORTANT]  
> Tool calling works best with models that support function calling, such as Claude, GPT-4, Mistral, Llama, or Qwen.

## Examples

Test the server by asking the LLM to generate a random event. The unique format should make it clear whether the tool is working or if the LLM is hallucinating results.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jnaskali](https://github.com/jnaskali)
- **Source:** [jnaskali/rpg-mcp](https://github.com/jnaskali/rpg-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-jnaskali-rpg-mcp
- Seller: https://agentstack.voostack.com/s/jnaskali
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.