@iamjameslennon/ddb-mcp 2.3.0

package/dist/index.js

@@ -0,0 +1,654 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { getBrowser, getContext, closeBrowser } from "./browser.js";
+import { login } from "./auth.js";
+import { getCharacter, downloadCharacter, listCharacters, parseCharacter, findCharacterByName, getDefinition } from "./tools/character.js";
+import { getCampaign, listMyCampaigns } from "./tools/campaign.js";
+import { navigate, interact, getCurrentPageContent } from "./tools/navigate.js";
+import { search } from "./tools/search.js";
+import { listLibrary, readBook } from "./tools/library.js";
+import { searchMonsters, getMonster } from "./tools/monster.js";
+import { rateEncounter, targetEncounterCr } from "./tools/encounter.js";
+import { generateTreasure } from "./tools/treasure.js";
+import { getCondition, searchSpells, getSpell, searchItems, getItem, searchRaces, searchClasses, searchBackgrounds, searchFeats, searchClassFeatures, searchRacialTraits, searchRules, getRule } from "./tools/reference.js";
+const server = new McpServer({
+    name: "dndbeyond",
+    version: "1.0.0",
+});
+// Lazy-initialized shared browser context (headless by default)
+async function getSharedContext() {
+    const browser = await getBrowser();
+    const context = await getContext(browser);
+    return context;
+}
+// Login-specific context — opens a visible window for the OAuth flow
+async function getLoginContext() {
+    const browser = await getBrowser(false);
+    const context = await getContext(browser);
+    return context;
+}
+// ─── ddb_login ────────────────────────────────────────────────────────────────
+server.tool("ddb_login", "Launch a browser and log into D&D Beyond. A Chrome window will open for you to complete login — it closes automatically once your session is saved. After that, character tools work without any browser.", {}, async () => {
+    try {
+        const context = await getLoginContext();
+        const result = await login(context);
+        // Close the browser immediately after saving the session — no need to
+        // keep it open since all API-based tools use the saved cookies directly.
+        await closeBrowser();
+        return { content: [{ type: "text", text: `${result}\nBrowser closed. Session saved to disk — no browser needed for future requests.` }] };
+    }
+    catch (err) {
+        // Still try to close the browser even if login failed
+        await closeBrowser().catch(() => { });
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_login error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Login failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_close_browser ───────────────────────────────────────────────────────
+server.tool("ddb_close_browser", "Close the background browser window if one is open. Useful after running ddb_navigate, ddb_interact, or ddb_get_page.", {}, async () => {
+    try {
+        await closeBrowser();
+        return { content: [{ type: "text", text: "Browser closed." }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_close_browser error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Failed to close browser: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_list_characters ──────────────────────────────────────────────────────
+server.tool("ddb_list_characters", "List all characters in your D&D Beyond account, including their ID, level, race, and class.", {}, async () => {
+    try {
+        const result = await listCharacters();
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_list_characters error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Failed to list characters: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_get_character_raw ────────────────────────────────────────────────────
+server.tool("ddb_get_character_raw", "Returns raw 300–500 KB character JSON. Requires confirm_large_response: true. Use ddb_get_character instead for all normal use.", {
+    character_id: z.string().min(1).optional().describe("The D&D Beyond character ID (e.g. '12345678')"),
+    character_name: z.string().min(1).optional().describe("Character name to look up (fuzzy matched against your account)"),
+    confirm_large_response: z.literal(true).describe("Must be true to proceed — acknowledges this call returns 300–500 KB."),
+}, async ({ character_id, character_name }) => {
+    try {
+        let resolvedId = character_id;
+        if (!resolvedId) {
+            if (!character_name) {
+                return { content: [{ type: "text", text: "Either character_id or character_name must be provided." }], isError: true };
+            }
+            const found = await findCharacterByName(character_name);
+            if (!found) {
+                return { content: [{ type: "text", text: `No character found matching "${character_name}". Try ddb_list_characters to see your characters.` }], isError: true };
+            }
+            resolvedId = found.id;
+        }
+        const data = await getCharacter(resolvedId);
+        return { content: [{ type: "text", text: data }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_get_character_raw error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Failed to get character: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_download_character ───────────────────────────────────────────────────
+server.tool("ddb_download_character", "Download a character's full JSON data to a local file.", {
+    character_id: z.string().min(1).describe("The D&D Beyond character ID"),
+    output_path: z
+        .string()
+        .optional()
+        .describe("Full file path to save to (defaults to ~/Downloads/{name}-{id}.json). Must be a path under ~/Downloads or ~/Documents."),
+}, async ({ character_id, output_path }) => {
+    try {
+        // No browser needed — uses saved session cookies directly
+        const result = await downloadCharacter(character_id, output_path);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_download_character error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Download failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_get_character ───────────────────────────────────────────────────────
+server.tool("ddb_get_character", "Parse and display a character sheet. Use sections to reduce output: summary (vitals+stats), combat (adds actions/weapons), spells (spellcasting only), inventory, features, or full (default).", {
+    character_id: z.string().min(1).optional().describe("The D&D Beyond character ID (e.g. '12345678')"),
+    character_name: z.string().min(1).optional().describe("Character name to look up (fuzzy matched — e.g. 'Throin' finds 'Thorin Ironforge')"),
+    sections: z.enum(["summary", "combat", "spells", "inventory", "features", "full"])
+        .default("full")
+        .describe("Which sections to return. Default: full. Use summary for a quick overview."),
+}, async ({ character_id, character_name, sections }) => {
+    try {
+        let resolvedId = character_id;
+        if (!resolvedId) {
+            if (!character_name) {
+                return { content: [{ type: "text", text: "Either character_id or character_name must be provided." }], isError: true };
+            }
+            const found = await findCharacterByName(character_name);
+            if (!found) {
+                return { content: [{ type: "text", text: `No character found matching "${character_name}". Try ddb_list_characters to see your characters.` }], isError: true };
+            }
+            resolvedId = found.id;
+        }
+        const summary = await parseCharacter(resolvedId, sections);
+        return { content: [{ type: "text", text: summary }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_get_character error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Failed to parse character: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_character_lookup ────────────────────────────────────────────────────
+server.tool("ddb_character_lookup", "Look up the full description of a spell, feat, class feature, subclass feature, racial trait, background feature, or equipped item by name. Supports partial and fuzzy name matching (e.g. 'cutting' finds Cutting Words, 'sheild' finds Shield). Accepts either a numeric character_id or a character_name.", {
+    character_id: z.string().min(1).optional().describe("The D&D Beyond character ID"),
+    character_name: z.string().min(1).optional().describe("Character name (fuzzy matched against your account)"),
+    name: z.string().min(1).describe("Name to search for — partial match, e.g. 'hunter' finds Hunter's Mark"),
+}, async ({ character_id, character_name, name }) => {
+    try {
+        let resolvedId = character_id;
+        if (!resolvedId) {
+            if (!character_name) {
+                return { content: [{ type: "text", text: "Either character_id or character_name must be provided." }], isError: true };
+            }
+            const found = await findCharacterByName(character_name);
+            if (!found) {
+                return { content: [{ type: "text", text: `No character found matching "${character_name}". Try ddb_list_characters to see your characters.` }], isError: true };
+            }
+            resolvedId = found.id;
+        }
+        const result = await getDefinition(resolvedId, name);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_character_lookup error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Definition lookup failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_search_monsters ──────────────────────────────────────────────────────
+server.tool("ddb_search_monsters", "Search the D&D Beyond monster compendium by name, CR, type, or size. Returns a summary list. Use ddb_get_monster for the full stat block. Requires login.", {
+    name: z.string().optional().describe("Partial name to search for (e.g. 'goblin', 'dragon')"),
+    cr: z.number().optional().describe("Challenge Rating filter (e.g. 0.25, 1, 5, 20)"),
+    type: z.string().optional().describe("Monster type filter (e.g. 'undead', 'fiend', 'beast')"),
+    size: z.string().optional().describe("Size filter (e.g. 'large', 'tiny')"),
+}, async ({ name, cr, type, size }) => {
+    try {
+        const result = await searchMonsters({ name, cr, type, size });
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_monsters error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Monster search failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_get_monster ──────────────────────────────────────────────────────────
+server.tool("ddb_get_monster", "Get the full stat block for a specific monster from the D&D Beyond compendium. Searches by name (partial match). Requires login.", {
+    name: z.string().min(1).describe("Monster name (e.g. 'Beholder', 'Adult Red Dragon')"),
+}, async ({ name }) => {
+    try {
+        const result = await getMonster(name);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_get_monster error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Monster lookup failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_get_campaign ─────────────────────────────────────────────────────────
+server.tool("ddb_get_campaign", "Fetch campaign information including player characters, notes, and description from a D&D Beyond campaign page.", {
+    campaign_id: z.string().min(1).describe("The D&D Beyond campaign ID (found in the campaign URL)"),
+}, async ({ campaign_id }) => {
+    try {
+        const context = await getSharedContext();
+        const data = await getCampaign(context, campaign_id);
+        await closeBrowser();
+        return { content: [{ type: "text", text: data }] };
+    }
+    catch (err) {
+        await closeBrowser().catch(() => { });
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_get_campaign error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Failed to get campaign: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_list_campaigns ───────────────────────────────────────────────────────
+server.tool("ddb_list_campaigns", "List all D&D Beyond campaigns you are part of (as DM or player).", {}, async () => {
+    try {
+        const context = await getSharedContext();
+        const data = await listMyCampaigns(context);
+        await closeBrowser();
+        return { content: [{ type: "text", text: data }] };
+    }
+    catch (err) {
+        await closeBrowser().catch(() => { });
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_list_campaigns error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Failed to list campaigns: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_navigate ─────────────────────────────────────────────────────────────
+server.tool("ddb_navigate", "Navigate to any D&D Beyond URL and return the page's text content. Only dndbeyond.com URLs are allowed. The browser stays open after this call for follow-up ddb_interact or ddb_get_page calls. Call ddb_close_browser when finished.", {
+    url: z
+        .string()
+        .min(1)
+        .describe("Full D&D Beyond URL to navigate to (must start with https://www.dndbeyond.com/)"),
+}, async ({ url }) => {
+    try {
+        const context = await getSharedContext();
+        const content = await navigate(context, url);
+        return { content: [{ type: "text", text: content }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_navigate error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Navigation failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_interact ─────────────────────────────────────────────────────────────
+server.tool("ddb_interact", "Interact with the currently loaded D&D Beyond page by clicking, filling a form field, or taking a screenshot. The 'fill' action requires confirm_fill: true — this is a safety gate to prevent prompt injection on rendered DDB pages from triggering unintended form submissions.", {
+    action: z
+        .enum(["click", "fill", "screenshot"])
+        .describe("The action to perform: click an element, fill a text field, or take a screenshot"),
+    selector: z.string().min(1).describe("CSS or text selector for the target element. Prefer specific selectors to avoid matching hidden elements — e.g. 'button:visible:has-text(\"Spells\")' or '[role=\"tab\"]:has-text(\"Spells\")' rather than 'text=Spells', which may match hidden nav dropdowns on DnD Beyond pages. Hardcoded DnD Beyond class names are unreliable (CSS module hashes change)."),
+    value: z
+        .string()
+        .optional()
+        .describe("Value to type into the field (required for 'fill' action)"),
+    confirm_fill: z
+        .literal(true)
+        .optional()
+        .describe("Must be true when action is 'fill'. Verify the selector and value are correct before setting this."),
+}, async ({ action, selector, value, confirm_fill }) => {
+    if (action === "fill" && confirm_fill !== true) {
+        return {
+            content: [{ type: "text", text: "confirm_fill: true is required for fill actions — verify the selector and value are correct before proceeding." }],
+            isError: true,
+        };
+    }
+    try {
+        const context = await getSharedContext();
+        const result = await interact(context, action, selector, value);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_interact error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Interaction failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_get_page ─────────────────────────────────────────────────────────────
+server.tool("ddb_get_page", "Return the text content of the currently loaded page in the browser. The browser stays open — call ddb_close_browser when finished.", {}, async () => {
+    try {
+        const context = await getSharedContext();
+        const content = await getCurrentPageContent(context);
+        return { content: [{ type: "text", text: content }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_get_page error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Failed to get page content: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_search_site ──────────────────────────────────────────────────────────
+server.tool("ddb_search_site", "Search D&D Beyond for spells, monsters, magic items, races, classes, or feats.", {
+    query: z.string().min(1).describe("The search query (e.g. 'Fireball', 'Beholder', 'Vorpal Sword')"),
+    category: z
+        .enum(["spells", "monsters", "items", "races", "classes", "feats", "all"])
+        .optional()
+        .describe("Category to search within (defaults to 'all')"),
+}, async ({ query, category }) => {
+    try {
+        const context = await getSharedContext();
+        const results = await search(context, query, category ?? "all");
+        await closeBrowser();
+        return { content: [{ type: "text", text: results }] };
+    }
+    catch (err) {
+        await closeBrowser().catch(() => { });
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_site error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Search failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_list_library ─────────────────────────────────────────────────────────
+server.tool("ddb_list_library", "List all books and sourcebooks you own in your D&D Beyond library.", {}, async () => {
+    try {
+        const context = await getSharedContext();
+        const books = await listLibrary(context);
+        await closeBrowser();
+        return { content: [{ type: "text", text: books }] };
+    }
+    catch (err) {
+        await closeBrowser().catch(() => { });
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_list_library error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Failed to list library: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_read_book ────────────────────────────────────────────────────────────
+server.tool("ddb_read_book", "Read a D&D Beyond book. Specify chapter_slug for a chapter, query to jump to a heading, and max_chars to control response size.", {
+    book_slug: z
+        .string()
+        .min(1)
+        .regex(/^[a-z0-9][a-z0-9\-\/]*$/, "book_slug may only contain lowercase letters, digits, hyphens, and forward slashes")
+        .describe("The book slug from the D&D Beyond URL (e.g. 'players-handbook', 'dungeon-masters-guide')"),
+    chapter_slug: z
+        .string()
+        .regex(/^[a-z0-9][a-z0-9\-\/]*$/, "chapter_slug may only contain lowercase letters, digits, hyphens, and forward slashes")
+        .optional()
+        .describe("Optional chapter or section slug (e.g. 'classes/ranger'). If omitted, returns the book's table of contents."),
+    max_chars: z.number().int().min(500).max(8000).default(3000)
+        .describe("Max characters to return (default 3000). Increase for deeper reading."),
+    query: z.string().optional()
+        .describe("Jump to the first heading containing this text (e.g. 'spell slots', 'wild shape')."),
+}, async ({ book_slug, chapter_slug, max_chars, query }) => {
+    try {
+        const context = await getSharedContext();
+        const content = await readBook(context, book_slug, chapter_slug, max_chars, query);
+        await closeBrowser();
+        return { content: [{ type: "text", text: content }] };
+    }
+    catch (err) {
+        await closeBrowser().catch(() => { });
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_read_book error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Failed to read book: ${msg}` }], isError: true };
+    }
+});
+// ─── Reference Tools ──────────────────────────────────────────────────────────
+server.tool("ddb_get_condition", "Look up the rules text for a D&D condition (Blinded, Charmed, Frightened, Grappled, etc.). No login required.", {
+    name: z.string().min(1).describe("Condition name (e.g. 'frightened', 'grappled')"),
+}, async ({ name }) => {
+    const result = getCondition(name);
+    return { content: [{ type: "text", text: result }] };
+});
+server.tool("ddb_search_spells", "Search the full D&D Beyond spell compendium by name, level, school, concentration, or ritual. First call builds the compendium (slow); subsequent calls are instant. Requires login.", {
+    name: z.string().optional().describe("Partial spell name (e.g. 'fire' finds Fireball, Fire Storm, etc.)"),
+    level: z.number().int().min(0).max(9).optional().describe("Spell level (0 = cantrip)"),
+    school: z.string().optional().describe("School of magic (e.g. 'evocation', 'illusion')"),
+    concentration: z.boolean().optional().describe("Filter by concentration requirement"),
+    ritual: z.boolean().optional().describe("Filter by ritual tag"),
+    limit: z.number().int().min(1).max(100).default(20).describe("Max results to return (default 20)"),
+    offset: z.number().int().min(0).default(0).describe("Skip N results for pagination"),
+}, async ({ name, level, school, concentration, ritual, limit, offset }) => {
+    try {
+        const result = await searchSpells({ name, level, school, concentration, ritual, limit, offset });
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_spells error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Spell search failed: ${msg}` }], isError: true };
+    }
+});
+server.tool("ddb_get_spell", "Get the full description of any spell in the D&D Beyond compendium by name. Not limited to a character's known spells. Requires login.", {
+    name: z.string().min(1).describe("Spell name (e.g. 'Fireball', 'Hunter\\'s Mark')"),
+}, async ({ name }) => {
+    try {
+        const result = await getSpell(name);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_get_spell error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Spell lookup failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_search_equipment ────────────────────────────────────────────────────
+server.tool("ddb_search_equipment", "Search the D&D Beyond item/equipment compendium by name, rarity, or type. Covers mundane weapons (Longsword, Shortbow), armour (Plate, Chain Mail), adventuring gear, and magic items. Filter by rarity='common' to see only mundane equipment. Requires login.", {
+    name: z.string().optional().describe("Partial item name (e.g. 'sword', 'cloak')"),
+    rarity: z.string().optional().describe("Rarity filter (e.g. 'rare', 'legendary', 'uncommon')"),
+    type: z.string().optional().describe("Item type filter (e.g. 'weapon', 'armor', 'wondrous')"),
+}, async ({ name, rarity, type }) => {
+    try {
+        const result = await searchItems({ name, rarity, type });
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_equipment error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Item search failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_get_equipment ───────────────────────────────────────────────────────
+server.tool("ddb_get_equipment", "Get the full stats and description of any item or equipment in the D&D Beyond compendium by name. Works for mundane weapons (e.g. 'Longbow'), armour (e.g. 'Plate'), adventuring gear, and magic items. Requires login.", {
+    name: z.string().min(1).describe("Item name (e.g. 'Bag of Holding', 'Flame Tongue')"),
+}, async ({ name }) => {
+    try {
+        const result = await getItem(name);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_get_equipment error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Item lookup failed: ${msg}` }], isError: true };
+    }
+});
+server.tool("ddb_search_races", "Search all D&D Beyond races and subraces (including homebrew). Not character-specific.", {
+    name: z.string().optional().describe("Partial race name (e.g. 'elf', 'tiefling')"),
+    limit: z.number().int().min(1).max(100).default(30).describe("Max results (default 30)"),
+    offset: z.number().int().min(0).default(0).describe("Skip N results for pagination"),
+}, async ({ name, limit, offset }) => {
+    try {
+        const result = await searchRaces(name, limit, offset);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_races error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Race search failed: ${msg}` }], isError: true };
+    }
+});
+server.tool("ddb_search_classes", "Search all D&D Beyond classes with hit die, spellcasting, and subclasses.", {
+    name: z.string().optional().describe("Partial class name (e.g. 'fighter', 'wizard')"),
+    limit: z.number().int().min(1).max(100).default(30).describe("Max results (default 30)"),
+    offset: z.number().int().min(0).default(0).describe("Skip N results for pagination"),
+}, async ({ name, limit, offset }) => {
+    try {
+        const result = await searchClasses(name, limit, offset);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_classes error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Class search failed: ${msg}` }], isError: true };
+    }
+});
+server.tool("ddb_search_backgrounds", "Search all D&D Beyond backgrounds (including homebrew).", {
+    name: z.string().optional().describe("Partial background name (e.g. 'sage', 'criminal')"),
+    limit: z.number().int().min(1).max(100).default(30).describe("Max results (default 30)"),
+    offset: z.number().int().min(0).default(0).describe("Skip N results for pagination"),
+}, async ({ name, limit, offset }) => {
+    try {
+        const result = await searchBackgrounds(name, limit, offset);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_backgrounds error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Background search failed: ${msg}` }], isError: true };
+    }
+});
+server.tool("ddb_search_feats", "Search feats by name or prerequisite text.", {
+    name: z.string().optional().describe("Partial feat name (e.g. 'sharpshooter', 'magic')"),
+    prerequisite: z.string().optional().describe("Filter by prerequisite text (e.g. 'spellcaster', 'level 4')"),
+    limit: z.number().int().min(1).max(100).default(30).describe("Max results (default 30)"),
+    offset: z.number().int().min(0).default(0).describe("Skip N results for pagination"),
+}, async ({ name, prerequisite, limit, offset }) => {
+    try {
+        const result = await searchFeats({ name, prerequisite, limit, offset });
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_feats error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Feat search failed: ${msg}` }], isError: true };
+    }
+});
+server.tool("ddb_search_class_features", "Search class features by name, class, or level gained.", {
+    name: z.string().optional().describe("Partial feature name (e.g. 'action surge', 'sneak attack')"),
+    class_name: z.string().optional().describe("Class name filter (e.g. 'fighter', 'rogue')"),
+    level: z.number().int().min(1).max(20).optional().describe("Level at which the feature is gained"),
+    limit: z.number().int().min(1).max(100).default(30).describe("Max results (default 30)"),
+    offset: z.number().int().min(0).default(0).describe("Skip N results for pagination"),
+}, async ({ name, class_name, level, limit, offset }) => {
+    try {
+        const result = await searchClassFeatures({ name, className: class_name, level, limit, offset });
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_class_features error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Class feature search failed: ${msg}` }], isError: true };
+    }
+});
+server.tool("ddb_search_racial_traits", "Search racial traits by name or race.", {
+    name: z.string().optional().describe("Partial trait name (e.g. 'darkvision', 'breath weapon')"),
+    race_name: z.string().optional().describe("Race name filter (e.g. 'elf', 'dragonborn')"),
+    limit: z.number().int().min(1).max(100).default(30).describe("Max results (default 30)"),
+    offset: z.number().int().min(0).default(0).describe("Skip N results for pagination"),
+}, async ({ name, race_name, limit, offset }) => {
+    try {
+        const result = await searchRacialTraits({ name, raceName: race_name, limit, offset });
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_racial_traits error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Racial trait search failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_search_rules ─────────────────────────────────────────────────────────
+server.tool("ddb_search_rules", "Search the SRD rules sections by keyword. Searches across section names and full content — e.g. 'grapple' finds the Attacking section (which covers grapple rules) and the Conditions section (which has the Grappled condition). Returns a list of matching sections with their slugs. Use ddb_get_rules to read the full text of a section. No login required.", {
+    query: z.string().optional().describe("Keyword to search for (e.g. 'grapple', 'concentration', 'death saving throw'). Omit to list all 45 available sections."),
+}, async ({ query }) => {
+    try {
+        const result = await searchRules(query);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_search_rules error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Rules search failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_get_rules ────────────────────────────────────────────────────────────
+server.tool("ddb_get_rules", "Get the full SRD rules text for a topic by section name or slug. Covers all core 5e rules: Spellcasting, Abilities, Attacking, Combat Sequence, Actions in Combat, Damage and Healing, Conditions, Movement, Multiclassing, Rest, Saving Throws, Environment, Traps, Diseases, Madness, Poisons, Weapons, Armor, and more. Use query to jump to a specific topic within a long section. For non-SRD rules or more detail, use ddb_read_book. No login required.", {
+    name: z.string().min(1).describe("Section name or slug (e.g. 'Spellcasting', 'attacking', 'Damage and Healing', 'multiclassing')"),
+    max_chars: z.number().int().min(500).max(30000).default(4000).describe("Max characters to return (default 4000). Some sections are 20,000+ chars — increase if you need the full text."),
+    query: z.string().optional().describe("Jump to the first occurrence of this keyword within the section (e.g. 'concentration', 'death saving throw')."),
+}, async ({ name, max_chars, query }) => {
+    try {
+        const result = await getRule(name, max_chars, query);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_get_rules error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Rules lookup failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_rate_encounter ───────────────────────────────────────────────────────
+server.tool("ddb_rate_encounter", "Rate the difficulty of a D&D encounter. Defaults to 2024 XDMG rules (Low/Moderate/High, no multiplier). Set rules_edition to '2014' for the classic DMG XP threshold method (Easy/Medium/Hard/Deadly with encounter multiplier). Monsters are looked up in the compendium automatically — supply 'cr' directly for homebrew.", {
+    party: z.array(z.object({
+        count: z.number().int().min(1).max(20)
+            .describe("Number of characters at this level"),
+        level: z.number().int().min(1).max(20)
+            .describe("Character level"),
+    })).min(1).describe("Party composition. Use multiple entries for mixed-level parties — e.g. [{count:3,level:5},{count:1,level:3}]"),
+    monsters: z.array(z.object({
+        name: z.string().optional()
+            .describe("Monster name — looked up in the compendium (DDB with Open5e fallback)"),
+        cr: z.number().optional()
+            .describe("CR as a decimal — 0.125, 0.25, 0.5, or 1–30. Use for homebrew or instead of name"),
+        count: z.number().int().min(1).default(1)
+            .describe("Number of this monster (default 1)"),
+    })).min(1).describe("Monsters in the encounter. Each entry needs at least a name or cr."),
+    rules_edition: z.enum(["2024", "2014"]).default("2024")
+        .describe("Rules edition. '2024' (default) uses XDMG XP budgets with Low/Moderate/High difficulty — no encounter multiplier. '2014' uses DMG XP thresholds with Easy/Medium/Hard/Deadly and a monster count multiplier."),
+}, async ({ party, monsters, rules_edition }) => {
+    try {
+        const result = await rateEncounter(party, monsters, rules_edition);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_rate_encounter error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Encounter rating failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_encounter_cr ─────────────────────────────────────────────────────────
+server.tool("ddb_encounter_cr", "Given a party and a target difficulty, returns the CR to aim for — broken down by encounter shape (solo boss, duo, squad, horde). Defaults to 2024 XDMG rules; set rules_edition to '2014' for classic DMG. No monster lookup required. Use with ddb_rate_encounter to verify a specific monster list.", {
+    party: z.array(z.object({
+        count: z.number().int().min(1).max(20).describe("Number of characters at this level"),
+        level: z.number().int().min(1).max(20).describe("Character level"),
+    })).min(1).describe("Party composition — same format as ddb_rate_encounter"),
+    difficulty: z.enum(["low", "moderate", "high", "easy", "medium", "hard", "deadly"])
+        .describe("Target difficulty. Use 'low', 'moderate', 'high' for 2024 rules; 'easy', 'medium', 'hard', 'deadly' for 2014 rules."),
+    monster_count: z.number().int().min(1).optional()
+        .describe("If provided, shows only this count instead of all four archetypes"),
+    rules_edition: z.enum(["2024", "2014"]).default("2024")
+        .describe("Rules edition. '2024' (default) uses XDMG XP budgets, no multiplier. '2014' uses DMG XP thresholds with encounter multiplier."),
+}, async ({ party, difficulty, monster_count, rules_edition }) => {
+    try {
+        const result = await targetEncounterCr(party, difficulty, monster_count, rules_edition);
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_encounter_cr error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Encounter CR lookup failed: ${msg}` }], isError: true };
+    }
+});
+// ─── ddb_roll_treasure ───────────────────────────────────────────────────────
+server.tool("ddb_roll_treasure", "Generate a treasure reward using the 2024 XDMG treasure tables (default). Provide either a CR directly or a list of monster names — CR is resolved automatically via fuzzy name matching. treasure_type 'hoard' makes one roll using the highest CR and includes magic items (requires character_level); 'individual' rolls once per monster and sums the results.", {
+    cr: z.number().min(0).max(30).optional()
+        .describe("Challenge rating (0–30). Use instead of monsters for a direct CR lookup."),
+    monsters: z.array(z.object({
+        name: z.string().describe("Monster name — fuzzy matched, DDB with Open5e fallback"),
+        count: z.number().int().min(1).default(1).describe("Number of this monster (default 1)"),
+    })).optional()
+        .describe("Monsters from the encounter. Highest CR determines the treasure tier for hoards."),
+    treasure_type: z.enum(["individual", "hoard"]).default("hoard")
+        .describe("individual = one roll per monster. hoard = one roll using the highest CR."),
+    character_level: z.number().int().min(1).max(20).optional()
+        .describe("Character level (1–20). Required for hoard treasure to determine which magic item table to use. If omitted, magic items are skipped."),
+}, async ({ cr, monsters, treasure_type, character_level }) => {
+    try {
+        const result = await generateTreasure({ cr, monsters, treasureType: treasure_type, characterLevel: character_level });
+        return { content: [{ type: "text", text: result }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[ddb-mcp] ddb_roll_treasure error: ${msg}\n`);
+        return { content: [{ type: "text", text: `Treasure generation failed: ${msg}` }], isError: true };
+    }
+});
+// ─── Graceful shutdown ────────────────────────────────────────────────────────
+async function shutdown(signal) {
+    process.stderr.write(`[ddb-mcp] Received ${signal}, shutting down...\n`);
+    await closeBrowser().catch(() => { });
+    process.exit(0);
+}
+process.on("SIGTERM", () => { void shutdown("SIGTERM"); });
+process.on("SIGINT", () => { void shutdown("SIGINT"); });
+// ─── Start server ─────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write("D&D Beyond MCP server running on stdio\n");
+}
+main().catch((err) => {
+    process.stderr.write(`Fatal error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map