Skip to main content

Developer Wiki

Doungim is a TTRPG gaming console for D&D and other tabletop role-playing games. Our public D&D resource library (about 9,300 pages — every spell, monster, magic item, feat, NPC, name, place, and 118,000+ random encounter scenarios) is free to use under CC-BY-4.0 with attribution.

We expose the library through three surfaces:

  • REST API at https://www.doungim.com/api/v1/dnd — plain JSON, CORS-enabled, cache-friendly. Reference →
  • Model Context Protocol at https://www.doungim.com/mcp — any MCP-capable AI client can connect and call tools. Guide →
  • Embed widget at https://www.doungim.com/embed.js — one script tag drops spell, monster, magic-item, and NPC cards into any blog. Guide →

All Wiki Pages

Overview
Why This Is Free

Why Doungim opens its full D&D reference library — REST, MCP, embed — to anyone. The community is the reason the table works, and we want every D&D session to be a good one, with or without our console.

Overview
Getting Started

Pick the right surface — MCP, REST API, embed widget — in two minutes. Includes the citation requirement every integration must honour.

API
REST API Reference

Endpoint catalogue for /api/v1/dnd: search, spells, monsters, magic items, NPCs, encounter tables, FAQ. Full request and response shapes.

Examples
REST API Examples

Copy-paste examples in curl, JavaScript (fetch), Python (requests), and TypeScript for every endpoint.

MCP
MCP Server Guide

Connect any Model Context Protocol client to https://www.doungim.com/mcp. Eight tools, no authentication, citation built into the protocol.

Examples
MCP Client Examples

Wire Claude, ChatGPT desktop, Cursor, Cline, and other MCP-capable clients to Doungim. Connection JSON for each.

Embed
Embed Widget Guide

Drop spell, monster, magic-item, and NPC cards into any blog with a single <div> tag. Theme options, sizing, and the resize protocol.

API
OpenAPI 3.1 Spec

Machine-readable description of every REST endpoint. Drop the URL into Postman, Swagger UI, Insomnia, or the OpenAI tool-generator.

License & Branding
Licensing & Attribution

All content is CC-BY-4.0. What that requires, how to credit Doungim correctly, and where the brand line goes in product UI.

API
Rate Limits & Caching

Public endpoints are CDN-cached, but high-volume callers should mirror the data. Recommended cache TTLs and freshness signals.

Citation requirement (mandatory)

Every API response, MCP tool result, and embed card includes a _citation block (or the equivalent for the embed footer). When you put Doungim data in a public-facing product, please credit Doungim and link the canonical_url per the licence terms. The brand line: "Doungim — a TTRPG gaming console for D&D and other tabletop role-playing games".