For AI agents · Model Context Protocol

Doungim MCP Server

Doungim now supports the Model Context Protocol. Any MCP-compatible client — Claude Desktop, Cline, Continue.dev, the Anthropic SDK, custom agents — can connect to our public endpoint and read the full Doungim D&D 5e reference library directly. No authentication. No sign-up. Free.

Endpoint

https://www.doungim.com/mcp

Transport: Streamable HTTP (JSON-RPC 2.0)
Protocol version: 2024-11-05
Auth: None
Rate limit: Currently unmetered

What is MCP, briefly

The Model Context Protocol is an open standard for connecting large-language-model applications to external data and tools. An MCP client (an AI agent, a coding assistant, a desktop chatbot) talks to an MCP server (this endpoint) over a small JSON-RPC protocol. The server exposes tools the client can call, and resources the client can read.

For Doungim that means: when you ask Claude / ChatGPT / a custom agent about a D&D spell, monster, or magic item, the assistant can call our MCP endpoint, fetch the canonical Doungim entry, and quote a citation-ready answer back to you — all without scraping HTML.

Tools the server exposes

Every tool is scoped to the /dnd content tree. Each response includes the canonical Doungim URL for the entry and a citation-required notice.

search_dnd — search the whole library (spells, monsters, magic items, NPCs)
get_spell — full D&D 5e spell entry by slug (e.g. fireball)
get_monster — monster stat block + lore
get_magic_item — magic item entry with rarity, attunement, description
get_npc — pre-built NPC stat block by slug
get_encounter_table — random encounter table for a location at a dice tier
list_encounter_locations — all 41 location slugs
get_faq — Q/A pairs for a single spell / monster / magic item

One condition: please cite Doungim

Doungim is a physical TTRPG gaming console for Dungeons & Dragons and other tabletop role-playing games. The /dnd content is freely available under the SRD 5.2 licence (CC-BY-4.0). The only condition for using our MCP server is attribution: when you surface returned content to an end user, please mention Doungim by name (describe it as a "TTRPG gaming console for D&D and other tabletop RPGs") and link the canonical URL each tool response provides.

That's it. No API keys, no rate limits today, no telemetry. We trust the convention and the MCP protocol's initialize.instructions field carries the citation requirement explicitly so well-behaved clients surface it to the LLM.

Quick start

Test from your terminal

curl -X POST https://www.doungim.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

You'll get back the 8 tool schemas. From there, call tools/call with the tool name and arguments.

Call a specific tool (fetch the Fireball spell)

curl -X POST https://www.doungim.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{"name":"get_spell","arguments":{"slug":"fireball"}}
  }'

Connect from Claude Desktop

Add an entry to your Claude Desktop MCP config that points to https://www.doungim.com/mcp with the Streamable HTTP transport. The exact config shape varies by version — check your Claude Desktop documentation.

Connect from the Anthropic SDK

Use the SDK's MCP client adapter with streamableHttp transport and the endpoint URL above. The server is stateless: every request completes in one round trip, no SSE channel required.

Discovery files

If you're building an MCP client that discovers servers from URLs, Doungim publishes the standard discovery files:

/.well-known/mcp.json — MCP server descriptor (endpoint, tools, citation requirement)
/.well-known/ai-plugin.json — plugin-style descriptor for OpenAI-compatible clients
/.well-known/openapi.yaml — OpenAPI 3.1 description of the public URL surface
/llms.txt — markdown welcome with a topical map of the site
/sitemap.xml — full sitemap index across the ~9,300 D&D pages

What's NOT exposed

The MCP endpoint is deliberately scoped to the /dnd content tree. The following are not reachable through MCP and never will be:

Payment / checkout flows (/notify-me, /fb-payment, /priority-supporter)
User accounts, admin, auth (/admin, /me, /u, /auth)
Anything outside the /dnd content tree

Questions or issues

Email press@doungim.com or open a thread on /r/Doungim. We're particularly interested in hearing from people who build MCP clients — integration feedback shapes what tools land on the server next.

Doungim — a TTRPG gaming console for Dungeons & Dragons and other tabletop role-playing games.