MCP Server

Heroic Adventures
Assistant

Your AI-powered companion for Heroic Adventures 2nd Edition. Connect it to Claude, Copilot, or any MCP-compatible AI and get instant access to rules, character building, encounter design, and more.

What Can It Do?

The assistant gives your AI deep knowledge of Heroic Adventures 2nd Edition. Here's what becomes possible:

πŸ“–

Rules Lookup

Ask about any rule β€” combat, spells, equipment, movement β€” and get accurate answers straight from the rulebook.

βš”οΈ

Character Creation

Build complete characters from concept to ready-to-play sheet, with race, class, spells, and equipment all accounted for.

πŸ‰

Encounter Design

Generate balanced encounters with proper difficulty scaling, monster selection, and tactical terrain suggestions.

πŸ—ΊοΈ

Adventure Generation

Create full adventure hooks, one-shots, or campaign arcs tailored to your party's level and play style.

πŸ‘Ή

Monster Building

Design custom monsters from a theme or role, complete with stat blocks, abilities, and action economy.

🎲

Session Support

Run live sessions with turn adjudication, quick rulings, treasure drops, and NPC generation on the fly.

How It Works

This server uses the Model Context Protocol (MCP) β€” an open standard that lets AI assistants connect to external knowledge sources. Think of it as giving your AI a copy of the Heroic Adventures rulebook.

1

You connect your AI

Add our server URL to your AI app's settings. It takes about 30 seconds.

2

Your AI gains Heroic Adventures knowledge

It can now look up chapters, rules, skills, and agent personas from the full 2nd Edition rulebook.

3

Ask it anything

Build characters, design encounters, look up rules, generate adventures β€” all through natural conversation.

Get Connected in Minutes

Choose your AI app below and follow the steps. No coding required!

1

Open Claude Settings

In the Claude desktop app, go to Settings β†’ MCP Servers (or Developer β†’ Edit Config on older versions).

2

Add a New Server

Click "Add Server" or edit your config file. Add the following:

MCP Configuration
{
  "servers": {
    "heroic-adventures": {
      "type": "http",
      "url": "https://mcp.heroicadventures.app/mcp"
    }
  }
}

See the Claude MCP docs.

3

Start Chatting!

Open a new conversation. Claude now has access to the full Heroic Adventures rulebook. Try asking: "Build me a Level 3 Dwarf Fighter"

1

Open VS Code Settings

Open VS Code and go to your Settings (Cmd+, on Mac, Ctrl+, on Windows).

2

Add MCP Server Config

Search for "MCP" in settings, or create/edit a .vscode/mcp.json file in any workspace. See the VS Code MCP docs.

.vscode/mcp.json
{
  "servers": {
    "heroic-adventures": {
      "type": "http",
      "url": "https://mcp.heroicadventures.app/mcp"
    }
  }
}
3

Use Copilot Chat

Open Copilot Chat in VS Code. It can now access Heroic Adventures content. Try: "What are the rules for initiative?"

1

Open Codex Config

In the Codex IDE extension, go to MCP settings > Open config.toml. Or edit ~/.codex/config.toml (or project .codex/config.toml). See Codex MCP docs.

2

Add the Server

Add this to your config.toml under [mcp_servers]:

config.toml
[mcp_servers.heroic-adventures]
url = "https://mcp.heroicadventures.app/mcp"
3

Start Using

Run codex mcp to verify. Ask Codex: "Build a level 3 fighter in Heroic Adventures"

1

Create Cursor MCP Config

Create/edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-specific). See Cursor MCP docs.

2

Add Heroic Adventures Server

Add this to your mcp.json:

mcp.json
{
  "mcpServers": {
    "heroic-adventures": {
      "url": "https://mcp.heroicadventures.app/mcp"
    }
  }
}
3

Reload and Use

Restart Cursor or reload window (Cmd+R). Ask in chat: "What are Heroic Adventures spells?"

1

Add this Streamable HTTP MCP server URL to any MCP-compatible app

Server URL
https://mcp.heroicadventures.app/mcp

Available Tools

Once connected, your AI automatically gets access to these tool categories:

πŸ“œ Chapters

All 12 chapters of the rulebook β€” from Introduction to the Monster Manual. Full text, searchable by your AI.

list_chapter get_chapter get_chapter_content

βš–οΈ Rules

17 thematic rule summaries covering combat, spells, equipment, leveling, mass battle, and more.

list_rule get_rule get_rule_content

πŸ› οΈ Skills

17 ready-made skill templates β€” character creation, encounter building, session prep, treasure drops, and more.

list_skill get_skill get_skill_content

🎭 Agents

5 specialized AI personas β€” Heroic GM, Rules Librarian, Character Builder, Encounter Designer, and Campaign Architect.

list_agent get_agent get_agent_content

Frequently Asked Questions

Not at all! If you can copy and paste a URL into your AI app's settings, you're good to go. The setup takes about 30 seconds.

Yes, the Heroic Adventures Assistant is completely free to use. You just need a subscription to an AI app that supports MCP (like Claude Pro or VS Code with Copilot).

Any app that supports the Model Context Protocol (MCP) with Streamable HTTP transport. This includes Claude Desktop, VS Code with GitHub Copilot, and a growing number of other AI tools.

Anything about Heroic Adventures 2nd Edition! Examples: "Build me a Level 5 Elf Mage", "What are the rules for opportunity attacks?", "Design an encounter for 4 Level 3 players", "Generate a dungeon adventure hook", "What spells does a Cleric get at Level 4?"

The MCP server itself is stateless β€” it just provides rulebook knowledge. But your AI app (like Claude) remembers context within a conversation, so you can build on previous answers during a session.

The server always has the latest version of the Heroic Adventures 2nd Edition content. Updates are deployed automatically β€” no action needed on your end.

Ready to Level Up Your Game?

Connect in under a minute and let AI handle the rules while you focus on the adventure.

Get Started Now