Migadu MCP Server

Instructions

Implementation Reference

• migadu_mcp/tools/alias_tools.py:242-260 (handler)

  The main MCP tool handler function 'delete_alias' that orchestrates bulk alias deletion using the process_delete_alias helper.
  @mcp.tool( annotations={ "readOnlyHint": False, "destructiveHint": True, "idempotentHint": True, "openWorldHint": True, }, ) async def delete_alias( targets: List[Dict[str, Any]], ctx: Context ) -> Dict[str, Any]: """Delete aliases. DESTRUCTIVE: Cannot be undone. List of dicts with: target (local part), domain (optional).""" count = len(list(ensure_iterable(targets))) await log_bulk_operation_start(ctx, "Deleting", count, "alias") await ctx.warning("🗑️ DESTRUCTIVE: This operation cannot be undone!") result = await process_delete_alias(targets, ctx) await log_bulk_operation_result(ctx, "Alias deletion", result, "alias") return result
• migadu_mcp/tools/alias_tools.py:215-241 (helper)

  Core processing logic for individual alias deletion, including validation, logging, and service call.
  @bulk_processor_with_schema(AliasDeleteRequest) async def process_delete_alias( validated_item: AliasDeleteRequest, ctx: Context ) -> Dict[str, Any]: """Process a single alias deletion with Pydantic validation""" # Use validated Pydantic model directly - all validation already done target = validated_item.target domain = validated_item.domain # Get domain if not provided if domain is None: from migadu_mcp.config import get_config config = get_config() domain = config.get_default_domain() if not domain: raise ValueError("No domain provided and MIGADU_DOMAIN not configured") email_address = format_email_address(domain, target) await ctx.warning(f"🗑️ DESTRUCTIVE: Deleting alias {email_address}") service = get_service_factory().alias_service() await service.delete_alias(domain, target) await log_operation_success(ctx, "Deleted alias", email_address) return {"deleted": email_address, "success": True}
• migadu_mcp/utils/schemas.py:181-186 (schema)

  Pydantic schema model 'AliasDeleteRequest' used by the bulk_processor for input validation in delete_alias tool.
  class AliasDeleteRequest(BaseModel): """Request schema for deleting an alias""" target: str = Field(..., description="Local part of alias") domain: Optional[str] = Field(None, description="Domain name")
• migadu_mcp/main.py:21-25 (registration)

  Registration of tool modules in the main MCP server initialization, including the alias_tools module containing delete_alias.
  register_mailbox_tools(mcp) register_identity_tools(mcp) register_alias_tools(mcp) register_rewrite_tools(mcp) register_resources(mcp)
• migadu_mcp/services/alias_service.py:52-57 (helper)

  AliasService method that performs the actual Migadu API DELETE request to remove the alias.
  async def delete_alias(self, domain: str, local_part: str) -> Dict[str, Any]: """Delete an alias""" return await self.client.request( "DELETE", f"/domains/{domain}/aliases/{local_part}" )