MCP Server

Heroic Adventures
MCP

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.

MCP Server URL

https://mcp.heroicadventures.app/mcp
https://mcp.heroicadventures.app/mcp

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.

Real Session Chat Demos

See how players and GMs use Heroic Adventures MCP during play for rules lookup, spell details, and dice roll support.

πŸ“– Rules Lookup (In Combat)

GM: "Does disengaging cancel attacks of opportunity?"

Assistant: "From Combat Rules: yes, a successful disengage prevents opportunity attacks this turn."

Assistant: "Use get_rule_content with combat for the full wording."

✨ Spell Details (At the Table)

Player: "What does Flame Lance do at Level 4?"

Assistant: "Flame Lance is a ranged spell attack that deals base fire damage plus scaling at higher caster levels."

Assistant: "I can also list similar offensive spells for this level range."

🎲 Dice + Rule Adjudication

GM: "Roll 2d20 keep highest for stealth, then apply nighttime penalty."

Assistant: "Rolled: 7, 16 β†’ keep 16. Night penalty -2. Final check: 14."

Assistant: "Stealth target was 13, so the party succeeds unnoticed."

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.

Integration Demos with Other MCPs

Combine Heroic Adventures MCP with your existing stack for campaign planning, notes, and live ops.

πŸ“ Notion + Heroic Adventures

Ask your AI to pull Heroic Adventures rules and publish a cleaned summary directly into your Notion campaign wiki.

πŸ—‚οΈ Notes MCP + Session Prep

Generate encounters with Heroic Adventures MCP, then save monster packs and treasure tables to your notes MCP automatically.

πŸ“† Calendar MCP + Story Arcs

Turn AI-generated plot beats into scheduled sessions and reminders so your table stays on track between games.

Quick-Start Client Guides

Pick your preferred AI client and connect in under a minute.

Claude

Add the MCP URL in Settings β†’ MCP Servers and start a new chat.

Cursor

Place the server in .cursor/mcp.json and reload your window.

VS Code + Copilot

Add to .vscode/mcp.json in your workspace settings.

Codex

Add a [mcp_servers.heroic-adventures] entry in config.toml.

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

Player & GM Stories

How tables are using Heroic Adventures MCP as an online rulebook and game assistant.

"We stopped pausing sessions to flip through books. The assistant resolves rules in seconds."

β€” Mara, Campaign GM

"Character creation became collaborative. New players ask questions naturally and get consistent answers."

β€” Devin, Weekly Player

"Using Heroic Adventures MCP with Notion lets me draft lore and publish session recaps in one flow."

β€” Riley, Worldbuilder

Available Tools

Once connected, your AI gets a mix of direct content tools and category-level default tools. This deployment exposes the commands below today:

πŸ“œ Chapters

All 12 chapters of the rulebook β€” from Introduction to the Monster Manual. Chapter lookups currently use the dedicated content tool.

list_chapter get_chapter_content

βš–οΈ Rules

17 thematic rule summaries covering combat, spells, equipment, leveling, mass battle, and more. Rules are exposed through the dedicated content tool.

list_rule get_rule_content

πŸ› οΈ Skills

17 ready-made skill templates β€” character creation, encounter building, session prep, treasure drops, and more. This category is configured with a default tool for faster access.

list_agent-skill get_agent-skill

🎭 Agents

5 specialized AI personas β€” Heroic GM, Rules Librarian, Character Builder, Encounter Designer, and Campaign Architect. Agent instructions are available through the category default tool.

list_agent get_agent

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