D&D MCP Server

Instructions

Implementation Reference

• src/gamemaster_mcp/main.py:540-558 (handler)

  MCP tool handler for 'list_quests'. Decorated with @mcp.tool for registration. Defines input schema via Annotated parameter, fetches quests via storage layer, and formats output list.

  @mcp.tool
  def list_quests(
      status: Annotated[Literal["active", "completed", "failed", "on_hold"] | None, Field(description="Filter by status")] = None,
  ) -> str:
      """List quests, optionally filtered by status."""
      quests = storage.list_quests(status)
  
      if not quests:
          filter_text = f" with status '{status}'" if status else ""
          return f"No quests found{filter_text}."
  
      quest_list = []
      for quest_title in quests:
          quest = storage.get_quest(quest_title)
          if quest:
              status_text = f" [{quest.status}]"
              quest_list.append(f"• {quest.title}{status_text}")
  
      return "**Quests:**\n" + "\n".join(quest_list)

• src/gamemaster_mcp/storage.py:369-378 (helper)

  Core storage method implementing quest listing logic. Retrieves quest titles from current campaign's quests dictionary, optionally filtering by status.

  def list_quests(self, status: str | None = None) -> list[str]:
      """List quest titles, optionally filtered by status."""
      if not self._current_campaign:
          return []
  
      quests = self._current_campaign.quests
      if status:
          return [title for title, quest in quests.items() if quest.status == status]
      return list(quests.keys())