# pirate-borg-mcp

An MCP server for [Pirate Borg](https://www.pirateborg.com/). Gives an LLM the tools it needs to generate stat-accurate NPCs using the procedural tables from the rulebook.

## Tools

### `create_character`

Generates a Pirate Borg NPC. The LLM provides narrative fields (name, faction, description, attack, inventory); the server rolls all numerical values from the enemy generator tables: HP, morale, armor tier, and the five ability score modifiers (Strength, Agility, Presence, Toughness, Spirit).

The LLM can optionally override `hp_tier` (1–10) or `armor_tier` (0–3) — useful for intentionally tough or lightly armored characters.

Returns a formatted markdown stat block.

## Setup

```bash
pnpm install
pnpm build
```

## Connecting to Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "pirate-borg": {
      "command": "node",
      "args": ["/absolute/path/to/pirate-borg-mcp/dist/index.js"]
    }
  }
}
```

## Development

```bash
pnpm dev   # runs src/index.ts directly with tsx (no build step)
```