@iamjameslennon/ddb-mcp
D&D Beyond MCP Server with Google Auth
Versions
2.10.2latest2.10.12.10.02.9.22.9.1+ show 10 moreshow less
2.9.02.8.02.7.12.7.02.6.42.6.12.5.02.4.32.4.22.3.0Tools 35
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.
ddb_close_browser Close the background browser window if one is open. Useful after running ddb_navigate, ddb_interact, or ddb_get_page.
ddb_clear_cache Wipe in-process caches so the next call re-fetches from D&D Beyond. Use this when search results look like the SRD/Open5e fallback (e.g. 2024 cantrips missing from spell results) after you
ddb_list_characters List all characters in your D&D Beyond account, including their ID, level, race, and class. Requires login — run ddb_login first if you haven
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. Requires login — run ddb_login first if you haven
ddb_download_character Download a character
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, concentration, notes (backstory, traits, bonds), or full (default). Requires login — run ddb_login first if you haven
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.
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.
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.
ddb_get_campaign Fetch campaign information including player characters from a D&D Beyond campaign. Requires login — run ddb_login first if you haven
ddb_list_campaigns List all D&D Beyond campaigns you are part of (as DM or player). Requires login — run ddb_login first if you haven
ddb_get_party Fetch a compact summary of every character in a campaign. Returns HP, AC, initiative, passive scores, ability scores, and skills for the whole party in one call. Requires login — run ddb_login first if you haven
ddb_navigate Navigate to any D&D Beyond URL and return the page
ddb_interact Interact with the currently loaded D&D Beyond page by clicking, filling a form field, or taking a screenshot. The
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.
ddb_search_site Search D&D Beyond for spells, monsters, magic items, races, classes, or feats.
ddb_list_library List all books and sourcebooks you own in your D&D Beyond library. Requires login — run ddb_login first if you haven
ddb_read_book Read a D&D Beyond book. Accepts either a slug (e.g. dnd/phb-2024) or a plain title (e.g. \
ddb_get_condition Look up the rules text for a D&D condition (Blinded, Charmed, Frightened, Grappled, etc.). No login required.
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.
ddb_get_spell Get the full description of any spell in the D&D Beyond compendium by name. Not limited to a character
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=
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.
ddb_search_races Search all D&D Beyond races and subraces (including homebrew). Not character-specific. Requires login — run ddb_login first if you haven
ddb_search_classes Search all D&D Beyond classes with hit die, spellcasting, and subclasses. Requires login — run ddb_login first if you haven
ddb_search_backgrounds Search all D&D Beyond backgrounds (including homebrew). Requires login — run ddb_login first if you haven
ddb_search_feats Search feats by name or prerequisite text. Requires login — run ddb_login first if you haven
ddb_search_class_features Search class features by name, class, or level gained. Requires login — run ddb_login first if you haven
ddb_search_racial_traits Search racial traits by name or race. Requires login — run ddb_login first if you haven
ddb_search_rules Search the SRD rules sections by keyword. Searches across section names and full content — e.g.
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.
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
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
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
Permissions 3
network medium shell high env_vars low