update_quest
Modify quest progress by updating status or marking objectives as completed in Dungeons & Dragons campaigns.
Instructions
Update quest status or complete objectives.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Quest title | |
| status | No | New quest status | |
| completed_objective | No | Objective to mark as completed |
Implementation Reference
- src/gamemaster_mcp/main.py:519-539 (handler)The MCP tool handler for 'update_quest'. Handles input parameters (schema), retrieves quest, updates status via storage helper or directly appends completed objectives, and saves changes.
@mcp.tool def update_quest( title: Annotated[str, Field(description="Quest title")], status: Annotated[Literal["active", "completed", "failed", "on_hold"] | None, Field(description="New quest status")] = None, completed_objective: Annotated[str | None, Field(description="Objective to mark as completed")] = None, ) -> str: """Update quest status or complete objectives.""" quest = storage.get_quest(title) if not quest: return f"Quest '{title}' not found." if status: storage.update_quest_status(title, status) if completed_objective: if completed_objective in quest.objectives and completed_objective not in quest.completed_objectives: quest.completed_objectives.append(completed_objective) storage._save_campaign() # Direct save since we modified the object return f"Updated quest '{title}'" - src/gamemaster_mcp/models.py:303-315 (schema)Pydantic model for Quest data structure. Defines fields like status, objectives, and completed_objectives used in the update_quest tool logic.
class Quest(BaseModel): """Quest or mission.""" id: str = Field(default_factory=lambda: random(length=8)) title: str description: str giver: str | None = None # NPC who gave the quest status: str = "active" # active, completed, failed, on_hold objectives: list[str] = Field(default_factory=list) completed_objectives: list[str] = Field(default_factory=list) reward: str | None = None notes: str = "" created_at: datetime = Field(default_factory=datetime.now) - Storage layer helper method that updates the status field on a Quest object and persists the campaign changes to disk.
def update_quest_status(self, title: str, status: str) -> None: """Update a quest's status.""" quest = self.get_quest(title) if quest: quest.status = status self._current_campaign.updated_at = datetime.now() # type: ignore self._save_campaign() - src/gamemaster_mcp/main.py:519-519 (registration)FastMCP decorator that registers the update_quest function as a tool.
@mcp.tool