MCP Open5E

An MCP (Model Context Protocol) server for the Open5E API, providing access to D&D 5e resources.

Installation

npm install
npm run build

Usage

Add to your opencode config:

{
  "mcp": {
    "open5e": {
      "command": ["node", "/path/to/mcp-open5e/dist/index.js"],
      "type": "local"
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | search | Search across all D&D 5e resources | | get_spells | Search and filter spells | | get_monsters | Search and filter monsters/NPCs | | get_classes | Get character classes | | get_races | Get character races | | get_backgrounds | Get character backgrounds | | get_feats | Get feats | | get_conditions | Get conditions (blinded, charmed, etc.) | | get_magic_items | Search magic items | | get_weapons | Get weapons | | get_armor | Get armor | | get_documents | Get available source documents |

Examples

• "Search for fire spells" → get_spells({ search: "fire" })
• "Get CR 5 monsters" → get_monsters({ cr: "5" })
• "Find rare magic items" → get_magic_items({ rarity: "rare" })
• "Get bard spells" → get_spells({ class_name: "bard" })

License

MIT