list_quests
Efficiently organize and view Dungeons & Dragons quests by filtering based on status—active, completed, failed, or on hold—using this tool.
Instructions
List quests, optionally filtered by status.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | Filter by status |
Implementation Reference
- src/gamemaster_mcp/main.py:540-558 (handler)The MCP tool handler for 'list_quests'. Decorated with @mcp.tool for registration. Includes input schema via Annotated. Lists quests filtered by optional status parameter, formats and returns as markdown string.@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)
- Helper method in storage class that retrieves list of quest titles, filtered by status if provided.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())