list_quests
Retrieve quests from your D&D campaign with optional status filters to track active, completed, failed, or on-hold adventures.
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)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)
- 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())